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Preface 


This manual is written for anyone who wants to use Amiga 
UNIX. It includes conceptual introductions to topics, 
instructions for common user and administrative tasks, and a 
reference section covering most major commands. 


Beginning users may want to start with a simpler book, such 
as Learning Amiga UNIX. Advanced users and administrators 
of large systems may want to supplement this book with 
selections from UNIX Press. 
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Using this manual 


Who should read 
this manual? 


What kind of 
book is it? 


Basic chapters 


Advanced 
chapters 


Using this manual 


This manual is directed at two audiences: 


¢* newcomers to UNIX who want an introduction to 
some of the most important features and 
commands 


°* experienced UNIX users who want to learn about 
new Amiga UNIX features 


Most of this book is written as an introductory 
reference guide, providing a little information about a 
large variety of common tasks. No previous 
knowledge is required; you can read any page at any 
time, and it should tell you what you need to get 
started with a task or command. If you need more 
advanced information, there are many other sources 
you can check. This manual is not intended to provide 
advanced information. 


The first six chapters cover basic tasks that any new 
UNIX user will encounter at some point (and which an 
experienced UNIX user will already know). The 
subjects include files and directories, online help, 
simple networking, printing, editing, and electronic 
mail. These chapters apply to many UNIX systems, 
not just Amiga UNIX, and could be used as an 
introductory guide for any UNIX System V Release 4 
system. 


The chapters become increasingly complex as you 
advance through the book; the second half (chapters 7 
through 11) present information that many novice 
users will not need to know. The final chapter is 
specifically a reference chapter. It covers many 
commands in a bit more detail than the rest of the 
book. 


Who should read 
which chapter? 


Terms 


Chapter What does it cover? 


Basic information for new users: 
getting started, online help 
Basic information for all users: 


files and directories, printing, 
editing in vi, using elm to send or 
read mail 


Overview of multi-user topics: 


multiple users, multiple login 
sessions, networking, exchanging 
files and messages, checking statu 


Advanced information: 


details of new Amiga Unix features 
and commands, system files, 
system maintenance overview for 
people who manage their own 
systems 


Reference chapter for all users 





Most of the terms in this document are explained 
where they are used; since each UNIX command tends 
to be its own odd form of abbreviated English, a 
glossary of terms would be a list of commands, or even 
a complete index. In general, no terms are used in a 
way that differs from standard UNIX or computer 
usage. 
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Press the RETURN 
key 


Conventions 


Using this manual 


We do not list the RETURN key each time it should be 
pressed; we assume that users either know or will 


quickly learn to end a command by pressing 
RETURN. 


Specific typographic conventions are used to either 
identify characteristics or focus your attention. These 
conventions are minimized so the manual reads as 
smoothly as possible. We use four such conventions, 
to show command lines in text, substitutions, keys, 
and the appearance of a screen. 


Four typographic 
conventions 


We use four typographic conventions in this manual 
to highlight specific concepts. 


What does it mean? 


bold words 


italics 


uppercase 


typewriter 
font 








a Unix command or command line: 
Is -It 
man Is 


a value to be substituted, frequently 
as part of a command line: 

filename 

cat filename 


also used for chapter and manual 
titles 

Using Amiga Unix 

Learning the Basics 


a key on the keyboard, or a 

combination of keys if connected by a 

hyphen: 
RETURN 
CTRL-C 


text that appears on your screen 
either as you type it or in response to 
your commands; values to be 
substituted by you are in italics 
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Notes for users 


Notes for 
experienced 
UNIX users 


Notes for PC 
users 


Using this manual 


Experienced UNIX users already know most or all of 
the information covered in the first six chapters; it’s 
straight UNIX, and the only parts you might not know 
are the System V Release 4 enhancements from AT&T 
and the unique additions of Amiga UNIX. Concentrate 
your attention on chapter 10, Maintaining your 
system (in case there are system files and 
administrative procedures that are new to you) and 
chapter 8, Special features of Amiga UNIX (which 
documents all the new Amiga UNIX commands). 


Your PC experience will make you a quick learner, but 
it may not help you to guess which UNIX command 
serves which purpose. (Once you become accustomed 
to the names and conventions, UNIX will seem easy; 
until then, you probably won’t find many familiar- 
sounding commands. ) 


As an experienced PC user, you might be able to skip 
the introductory chapters written for new users. 
However, these chapters are short, and they 
specifically focus on common computer tasks and how 
they are performed in UNIX. Since the tutorials in 
Learning to Use Amiga UNIX were written specifically 
to help PC users transfer to UNIX, we recommend that 
you read that book and then scan the first few 
chapters of this manual. 


PC commands 


Notes for new 
users 


Many 
information 
sources for new 
users 


vi 


You can also check the reference chapter at the end of 
the manual; the common MS-DOS commands are 
listed with their UNIX equivalents and, where 
appropriate, the combination of procedures you can 
use to imitate or expand on PC commands. 


New users should read the rest of this introduction; it 
highlights some important UNIX concepts that you 
might not have seen before. You should then skim the 
first few chapters, to see what kinds of commands and 
tasks are commonly used, then refer back to this book 
whenever you want to learn more about a specific 
topic. There is an easy progression to follow to find 
more information: 


e start with the index to this book, then read the 
appropriate paragraph or page to see how a task 
is performed 


e follow the tutorial in our companion book, 
Learning to Use Amiga UNIX, for hands-on 
instructions and examples 


e read the reference chapter at the end of this book 
for more options on a specific command 


¢ continue to the online man pages if you still need 
more information 


e read the detailed documentation in AT&T's 
complete UNIX PRESS documentation set for 
UNIX System V Release 4 
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Learning 
Amiga 
UNIX 


Read reference material in ascending order 


As a new user, you can probably become a competent 
UNIX user simply by reading the first few chapters of 
this book and following the tutorials in Learning to 
Use Amiga UNIX. 
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Basic features of UNIX 


Amiga UNIX 
virtual screens 


Multiple users 


If a command 
does not seem to 
work... 


viii 


UNIX has many features that are common on large 
multi-user computers, some that are unique to UNIX, 
and almost all of the features normally found in 
desktop personal computers. Describing these 
features would take an entire book; in fact, it usually 
takes about fifteen books. This manual is an overview 
to some important UNIX features; this page is a brief 
introduction to that overview. 


Note the following features and concepts. You will see 
them regularly throughout the manual and as you 
work at your computer using UNIX. 


Amiga UNIX adds virtual screens to UNIX; press 
any ALT-functionkey combination (F1 through 
F10) to change to a different login screen. 
Virtual screens make your one Amiga screen 
work like ten different screens, sharing one 
keyboard and monitor. 


UNIX is a multi-user and networking system; 
each virtual screen can be used" by a different 
user, as can any attached terminals or any 
remote network logins. You can communicate 
with these other users, see what they're doing, 
and even restrict them from specific files and 
commands. 


If a command does not work, you should first try 
typing it again. Some special characters do not 
appear on your screen; what looks like a clean 
command line might have garbage hidden on it. 
If you type a command several times and it still 
does not work, check the command syntax in this 
manual, then your path. It is important to have 
the command’s location in your path; UNIX 
searches only your path when you type a 
command, and does not look anywhere else. 
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CTRL-C to stop a 
process 


Processes run 


“invisibly” in 


background 


Directory tree 


Online help with 
man 
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If you start a command, you may not be able to 
do anything else until it finishes. Some 
commands can take a long time, particularly if 
you make a mistake and ask for the wrong 
operators (listing an entire hard disk, for 
example, instead of just your directory). Use 
CTRL-C to stop the current command. 


UNIX is a multi-tasking system; it runs many 
processes in the "background", where you cannot 
see them and they do not visibly interfere with 
your "foreground" work (what you type and see 
on the screen). If your system seems slow, you 
might have large processes running in the 
background. (UNIX itself always keeps 
processes running in the background, but it 
handles these so they do not take much 
computing power away from you.) To stop a 
background process, use the kill command. To 
keep working while a long, slow process 
continues, put it in the background. 


UNIX is very dependent on files and directories; 
most objects are in files or are processed through 
files, and all files are in directories. You should 
understand the basic file and directory concepts 
and commands documented in the first chapter 
of this manual. 


UNIX provides extensive online help, although in 
a somewhat cryptic fashion. Every UNIX 
command is documented in a "man page’; type 
man, followed by the name of a command, to get 
the man page for that command. Man pages 
document all the intricacies of a command, 
which makes them somewhat difficult for novice 
users to read and use. It’s still good to know that 
they’re there, so you can always look up 
information to learn about a command or try to 
fix a problem. (Note that on some smaller 
systems, a system administrator might remove 


Complete 
documentation 
from AT&T 


the man pages to make room for other files. The 
man pages represent several books of text and 
take up a lot of disk space.) 


AT&T provides a complete documentation set 
for UNIX System V Release 4. Since Amiga UNIX 
is an exact port of that system, you can read any 
part of this documentation. It is printed by 
Prentice Hall, and is available in many 
bookstores or directly from Prentice Hall. The 
only features not listed in the AT&T 
documentation are those which we added to 
Amiga UNIX and described in this manual. 
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Log in 





Type your username at the login prompt. Type your password at the 
password prompt. 


Virtual screens 





Alt-functionkey combinations control the virtual screens. 
Press ALT-F1 through ALT-F10 for different login screens. 





OPEN LOOK System status 
oladduser _ puts .olsetup ina who Check who is logged 
user’s .profile into the machine 
olinit start OPEN LOOK finger Similar to who but 
more details about 
users 


last List most recent login 
for one or more users 








ps List your processes 
ps-e List everyone’s 
processes 
UNIX shells 
/bin/sh Bourne shell. Historically the standard AT&T shell. 
/bin/csh C shell. Used by programmers and Berkeley enthusiast 
/bin/ksh Korn shell. Compatible with Bourne shell. Some C shel 


features. Easy command line editing. 
/usr/lib/rsh Restricted shell. Limits a user’s capabilities. 





peppjs Buiyjes 
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Why should you 
read this 
chapter? 


General features 
of UNIX 


User accounts 


Networking 
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You should read this chapter if you have never used 
UNIX before. If you already know UNIX, you should 
still skim this chapter to learn about the unique 
screen features of an Amiga terminal. 


UNIX in general has a few features that distinguish it 
from personal computer operating systems, including: 


e UNIX is multi-tasking 
e UNIX allows multiple user sessions 
e UNIX has a built-in security system 


e UNIX includes networking software and 
commands 


You can have many users and operations all working 
on your computer at the same time. You should learn 
how to keep track of these users and processes; 
remember, a computer that can do many things 
requires a little extra time to maintain, monitor, and 
learn. 


You must have a user account in order to work on a 
UNIX system. Every user account has a unique name 
and password associated with it. Unless you know 
this username and password, you will not be allowed 
on the computer. User accounts, usernames, and 
passwords are UNIX’s defense against unwanted 
users. 


UNIX provides the tools you need to communicate over 
a network. All you have to do is make the physical 
connection and configure the network software. 


Amiga UNIX 
virtual screens 


Amiga UNIX has a unique feature called virtual 
screens. You can have up to ten virtual screens, which 
means you can log in to your single computer ten 
times. Each of these screens can run any UNIX 
command, even windowing and graphics commands. 
It’s like having ten different terminals plugged into 
your computer. 


This chapter provides you with the basic information 
you need to start using Amiga UNIX, to use the virtual 
screens, and to keep track of users and processes on 
your computer. 
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Logging into your computer 


Login is a 
security feature 


Type your user 
name and 
password 


The password 
does not appear 
on the screen 


Geiting started 


: dog. 


UNIX provides a security feature called logging in. 
Any time you want to use a UNIX system, you must 
first log in by typing your username and password. 


a 
ee 








Your password does not appear on the screen as you 
type it. This prevents other people from reading your 
password over your shoulder. 


All UNIX systems have a user called root. root is the 
most powerful user on your computer and is 
sometimes called the "superuser". root has the power 
to override file protections and user security. root also 
has the power to damage your system. Log in as root 
only to perform system maintenance. Create your 
own user account for your regular work. 


You give other users permission to use your computer 
by setting up a login account for them. See chapter 
10, Maintaining your system, for information about 
setting up user accounts. 


Change your Change your password at any time by using the 
password passwd comand. 


passwd:changing password for username - 
Old password: : 


New password 
Re- eek new Ge 





Type your old password, then your new password, 
then confirm your new password by typing it again. 
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Using the virtual screens 


Press ALT anda 
function key to 
select a screen 


Check each 
function key fora 
screen 
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Use each virtual screen as if it is a Separate terminal. 
Press ALT-functionkey to change to the screen 


associated with that key. 









































Press Alt-Function keys for virtual screens 


If an empty black screen appears, you have not 
defined a screen for that function key. 


You can have many processes running on these 
virtual screens; logging off of one screen has no affect 
on the others. Check the screens currently running by 
pressing each ALT-functionkey combination in 
sequence. You should always check the current 
function keys after logging out, because you might 
have forgotten about some screens that are still in 
use. 


You create additional virtual screens by executing 
specific programs from the command line (such as 
olinit, which creates an X screen and an OPEN LOOK 
session at the maximum resolution of your monitor). 


Change screen 
characteristics 


Change screen 
color 


These screens are automatically associated with your 
current function key; that is, screens you create from 
F2 are also attached to F2 (stacked one behind the 
other). Since only the top screen is visible, you have 
to cancel it to see any other screens behind it. 


Screen settings may be different for different screens, 
since these settings are all customizable by a user or 
system administrator. By default, eight of the ten 
function keys are defined, with a variety of different 
colors, fonts, and resolution levels. You can set 
display characteristics in any of three ways: 


° system defaults 


¢ each virtual screen setting in inittab (see 
Editing system files later in this manual) 


e atthe command line for a particular session 


Change the current color with the color -be color -fc 
color command, using -be for background color and a 
number from 000 to fff. Each position in the number 
represents an amount for red, green, and blue, 
respectively. Changing these numbers individually 
allows a wide variety of color combinations between 
the darkest, 000, and the lightest, fff. Change the 
foreground color with -fe. In place of the exact number 
for a color, you can type the standard colors black, 
blue, green, cyan, red, magenta, yellow, and 
white, as shown in the screen on the next page. 
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Show current 
screen colors 


Choose a font 
type and size 
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set background set foreground 
color to blue color to white 





Look at the current background and foreground colors 
by typing color -show. Many colors are listed; the 
first two are the background and foreground colors, 
respectively. 


background foreground 
color color 





Because of the Amiga’s unique graphic processor, you 
can use different fonts, sizes, and colors, even when 
you are not running a graphic program (such as X) or 
graphical user interface (such as OPEN LOOK). You 
can get a login prompt, request and see UNIX 
commands, and even edit files in a variety of Amiga 
fonts. 


Change the font 
size and type 


At the present time, two Amiga fonts are shipped with 
Amiga UNIX release: 


¢ topaz8 (the default) 
° topazll 


Use sioc to change either the current font or the 
default font. sioc setfont filename changes the 
current font for this login session on this screen; sioc 
setfont resets the screen font to the default system 
font; and sioc setdeffont filename changes the 
system default font. 


change system 
default To.... topaz 11 





After they start, a short menu appears. Select 
"Programs... from this menu. Another menu appears 
with only one option: "Xterm..."; click on this option to 
start an X terminal window. 
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Using OPEN LOOK 


What is OPEN OPEN LOOK is a graphical user interface that lets you 

LOOK? run terminal windows and programs by clicking menu 
options and icons. You're still working in UNIX, but 
instead of having to type all the commands, you can 
select them from pull-down menus, operate others 
with a mouse, and have several running at the same 
time in different windows. 


Setting up OPEN OPEN LOOK doesn’t start by default, you configure it 

LOOK to run whenever you want. You only have to set up 
OPEN LOOK once, after that you can start it by typing 
a single command. 


To create your own OPEN LOOK environment, you 
first have to run the oladduser command. This 
program puts various OPEN LOOK and X Window 
System resource files in your home directory, and 
modifies your .profile. 





Log out then log back in to use your changed startup 
file. 
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OPEN LOOK and 
the C shell 


Start OPEN LOOK 
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The oladduser command doesn’t work with the C 
shell. If you use the C shell, copy the following files 
from /usr/X/adm into your home directory: 

e  .Xdefaults 

e .olinitre 

¢ .olprograms 
You also need to add the following lines to your .login 
file: 

e setenv DISPLAY unix:0 

e setenv XNETACCESS on 

¢ set path=( $path /usr/X/bin ) 


To start OPEN LOOK, type olinit and wait a minute 
for the OPEN LOOK windows and X Window System 
server to start. 
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The OPEN LOOK After OPEN LOOK starts, you see a single menu on a 

workspace blank screen. The following figure shows the 
workspace with an OPEN LOOK window and the 
workspace menu. 


workspace title bar 
menu 





Utilities b> 
Properties > 


\ crunchtkendall $ J 
Exit 


workspace window 
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Menus 


Three primary 
types of menus 
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Most menus under OPEN LOOK work the same way: 


e make them appear (if not already visible) by 
clicking the right mouse button 


¢ close or attach them by clicking the push pin at 
the top left corner of the menu with the left 
button 


¢ select options by clicking on them with the left 
button. 











ry workspace 


click to 

close or : 
click To 

attach the Utilities > select 

menu Properties b 


an options 


The mouse buttons are similarly consistent: the right 
mouse button usually brings up a menu and selects 
options from it, and the left button usually selects or 
drags an object. 


The three primary types of OPEN LOOK menus are: 
workspace, window, and application. Each type of 
menu is position-specific; you get a different one 
depending on where the mouse pointer is when you 
click the right mouse button. 


If you have an OPEN LOOK window open, move the 
mouse pointer into it and click the right mouse button. 
A menu for that window appears. Do the same thing 
for a different application and a different, application- 


Getting started 


Three types of 
menu options 


Getting started 


specific, set of menu options appears. You can also 
click on the blank workspace to get the workspace 
menu, or in the title bar of a window, to get the 
window menu. 





workspace menu 
(click in blank space) 


window menu 





application menu 


OPEN LOOK menu options do one of three things: 


start a submenu (...) 


start a dialogue box ( > ) 


start a program (no marker) 


leads to a submenu 













v weorkspagg 


L | 
Utilities b> 
Properties b 
Exit 





inn 


Programs 


Terminal Session 


Small Terminal Session 


Edit Programs... 
















starts a 
program 


leads fo a 
dialogue box 
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The workspace The workspace menu is the first menu you see after 

menu you start OPEN LOOK. You start all other OPEN LOOK 
programs, menus, and windows using the workspace 
menu. The table on the following page summarizes 
the workspace menu options. 


Where does it lead? 


Programs X programs and terminal windows 
Utilities Programs for managing the 


workspace 

Properties Change settings for mouse, icons, or 
keyboard 

Exit Quit OPEN LOOK completely and 
return to regular command prompt 





The window Another special menu, the window menu, has options 
menu for manipulating the window. The window menu 
options are the same for all windows. 


Window 


xterm 


-rw-r-—r— 4574 Sep 26 10¢37 passwd” 

-rworwcr 2220 Sep 27 10154 exports” 
Close eves 

-ru-runP 

-ru-r- Pa 


Restore Size deuxtusron 


Back 191280 Oct 16 17305 psdatabase 
213 Oct 16 17396 maotd 


4 Oct 16 17106 log,pid 
Refresh dct Get leivice an 
11838 Oct 16 17106 rmtab 


: 3 Oct 16 417306 state 
ult 8192 Oct 16 17306 ld,so,cache 





-rw-rw-r-— 
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Some common OPEN LOOK programs run in windows. Most OPEN 
features of OPEN LOOK windows share the following features: 


LOOK windows e Resize a window by clicking on one of the four 
corners and dragging. 


e Move a window by clicking anywhere on the 
border 


e Explode to fill a screen by double clicking on the 
title bar. Double-click again to switch back to 
normal size. 


e Shrink a window by selecting Close from the 
window menu. 


¢ Make a window active by clicking the left mouse 
button just inside the border or on the title bar. 
The title bar on the active window is black. Any 
characters you type appear only in the active 
window, regardless of where the pointer is. 


¢ Scroll through a window by clicking the scroll 
bar on the right side of the window. 


this button double click resize WiINdoW 
for Close to explode Cany corner) 
option or shrink 






aterm 

-rWw-P--Ph-— 4574 Sep 26 10¢a7 passwd” 

i a le 2220 Sep 27 10¢54 exports” 
select To =Kueh=<r—— Yel Sep 28 12109 group : 

—rw-rhu-Ph— 2470 Oct 10 09:59 exports : 
make -rw-r-—P-— 1010 Oct 11 11346 fstab Move 

‘ druxrwsr wx Bi2 Oct 15 12354 sm é ‘ 
window diruxrwsirw% Bi? Oct 15 12154 sm,bak WINdOW 
‘ —rw-r--P-— 4670 Oct 16 11317 passud : 

acitve -rw-r--r—— 16816 Oct 16 14:55 format,dat 


—PW-Ph--Ph-— 1041260 Oct 16 17105 psdatabase 
—PWw—-ru-PW— 243 Oct 16 17106 motd 

-PW-PW rh 4 Oct 16 17106 syslog,pid 
-Pwor--h-— 2310 Oct 16 17106 xtab 

Sd a el 0 11838 Oct 16 17106 rmtab 

—PW— rh 3 Oct 16 17106 state 
Pwr Pr 8192 Oct 16 17106 1ld,so,cache 
al een Ae Aoi 600 Oct 16 17106 ttys 

—FWR ho 999 Oct 16 17108 mtab 

Sl a heel toate toate 360 Oct 16 17? t24 networks 


al iL tl Ol to 13260 Oct 16 21144 dumpdates 
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Active windows 


The terminal 
window 


Advantages of a 
terminal window 
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You can open many windows at once, but only one can 
be active at a time. You can tell which window is 
active because it is usually the one at the very front 
(on top of the others) and its title bar is filled, while 
the others are empty. 


The terminal window (xterm) is OPEN LOOK’s 
equivalent of a virtual screen. You can type any UNIX 
command in a terminal window. The main difference 
is that virtual screens let you run foreground 
processes on different screens (function keys), while 
OPEN LOOK lets you run foreground processes in 
different windows on the same screen. 


Terminal windows have many advantages: 


¢ you can cut and paste commands between 
windows 


e you can scroll backwards to look at old 
commands 


* you can open many windows at once 
¢ you can change the window’s size 


e you can shrink the window so it is temporarily 
out of the way, even while a process is active 
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Start a terminal 
window 


Cut and paste 
between 
terminal 
windows 
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Start a terminal window by selecting Programs from 
the Workspace menu, then Terminal Session (large 
font) or Small Terminal Session (small font) from 
the Programs menu. 






Programs 


Terminal Session 


Small Terminal Session 
Clock 

Edit File 

Calculator 

Eyes 

X Logo 
String Art 




















Utilities b> 
Properties b> 
Exit 


You can move text between xterm windows by cutting 
and pasting. You copy text from one xterm (source), 
and paste it into the other xterm (destination). 


To copy text, you must first select the text you want to 
copy. Make the source xterm active by clicking on its 
title bar. Select the text you want to copy by putting 
the mouse pointer at the beggining of the text, clicking 
the left mouse button, and dragging unitl the text is 
darkened. 


16816 Oct 16 14255 format.dat 
O 16 17324 tworks 


<—___——-—s source xterm 
with text 


selected 


t. 
crunchtkendall ¢ §f 


UY 


galliumt/home/kendall 4] 











destination xterm 
where you are going 
to paste the text 
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Copy the text 


Paste the text 
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Copy the text using one of two methods: get the xterm 
menu (by pointing anywhere in the xterm window and 
clicking the right mouse button) and select Edit, then 
Copy from the Edit menu. As an alternative to the 
Edit menu, you can press CTRL and F2 to copy the 
text. 


Paste the text into the destination xterm by making 
that xterm active, positioning the mouse pointer 
where you want the text to appear, and pressing 
CTRL F4. You can also use the select the xterm 
menu, then Edit, then paste from the Edit menu to 
paste text. 


Getting started 


Scrolling back 
through old 


xterm 


commands 
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As you type more and more commands into the xterm 
window, the old ones scroll off the top of your screen. 
You can scroll back through them by using the scroll 


bar on the right side of the window. 







Y 


il a Steele Gienlae 
—PW-P Wh 
srw 
-PW-P Wh 
-ryw—-r--rh-— 
druxrwsrus 
druxrusrwx 
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-rucp rp 
-Pwor- Pp 
-rucrurw 
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-ru-r--h-— 
bel On 02 
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xterm 


4574 Sep 26 10137 passwd” 

2220 Sep 2? 10:54 exports” 

V74d Sep 28 12309 group 

2470 Oct 10 09759 reps 

1910 Oct 14 14146 fstab 

Si2 Oct 15 12354 sm 

Si2 Oct 15 12t54 sm.bak 

4670 Oct 16 14717 passud 
16816 Oct 16 14:55 format,dat 
191280 Oct 16 171505 peeaeaare 

213 Oct 16 17206 mo 

4 Oct 16 17196 Bee: pid 

2310 Oct 16 17106 xtab 

aieee Be 16 17106 rmtak 
t 16 17706 state 
e192 Oot 46 17306 ld,so,cache 
600 Oct 16 17706 ttys 

999 Oct 16 17108 mtab 

360 Oct 16 17324 networks 

1320 Oct 16 21141 dumpdates 


click here to 
move all the 
way Up 


click here to 
move up or 
down slowly 


click here to 
move all the 
way down 
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Customizing your environment 


Customizing your 
login 
environment 


Making acustom 
ksh prompt 
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When you first start UNIX, you are working in the 
default environment we set for you. You can change 
this environment by editing (or creating) a file called 
.profile in your home directory and filling it with your 
own custom settings. 


Your shell looks for a startup file in your home 
directory that contains information specific to you 
(such as what your prompt should look like and 
whether you want OPEN LOOK to start automatically). 
The Bourne and Korn shells (see Understanding the 
UNIX shells later in this chapter) use .profile, and the 
C shell uses .login. Both serve the same purpose. 


As an example of how a startup file affects your login 
session when you are using the Korn shell, type the 
following lines to put a file called .profile in your home 
directory. 


append to, or 
create file 
called .profile 


S Gat >> profile 
PSl= ‘uname’ ‘ \SPWD>’ 
expore PS 


CITROeC 


out these two lines in 


stop adding lines the .profile 


to the .profile 
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a es ee 


Log out and log in again. Your prompt should have 
the output of uname and the variable PWD, to show 
your system name and current directory. 


pamiga /home/usernames 





Set up aliases You can assign an alias to practically any UNIX 
command. Aliases let you change the name of a 
command, set the options for that command, or even 
combine commands. In fact, aliases let you 
completely customize UNIX commands to suit your 
needs. 


You define aliases in your .profile for the Korn shell 
(or .login for C shell). For example, you could make a 
new command to display the long Is sorted by time (Is 


-It). Here’s what you enter to make lt display Is -lt by 
default. 


Alias isis itt 





NOTE: The format for the alias 
command depends on the UNIX 
shell you are using. (See 
Understanding the UNIX shells 
later in this chapter.) 
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Checking on users and operations 


UNIX is a mullti- 
user operating 
system 


Check to see 
who is logged in 
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UNIX is a multi-user, multi-tasking operating system. 
You can have many people and operations working on 
your computer all at once. 


Virtual screens on your Dumb terminals connected 
monitor . to your system 
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i) 
Systems networked together 


Different ways of working with other users 


UNIX provides many commands for checking the 
status of your system. You can list processes, list 
people who are logged into your machine, list past 
activities, and control various commands. 


The who command lists the people who are logged in 
to your machine. This list includes users who are 

logged in at your monitor, on any terminals attached 
to your system, or remotely from a networked system. 
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Getting started 


yee. term/con4. 


| user name where user date and time 
logged in user logged in 


term/conS5 May 14 029-12. 


‘May 14 09.08 _ | | 


This example tells you that there are three people 





using your computer: two of them through the virtual 
screens on your monitor (term/con4 and term/con5) 


and one from over the network (pts/0). Remember 
that all the virtual screens share your monitor and 


keyboard; so even though two login sessions may be 
active, only one person is actually sitting in your chair 


using your keyboard. 
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Check on users 
with finger 


Comparing 
finger to who 


Use options with 
finger 
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Another useful command for checking on other users 
is finger. finger is similar to who, except it provides 
a little more information. Here’s an example showing 
the output from both who and finger: 


S finger 
Login Name TrY Idle When Where | 
joe Joe Jones term/con4 12 Mayl4 04 08 amiga 


S$ who : a rCC 
joe term/con4 Mayl4 04 08 





The most useful finger option is probably -l. 


S$ finger -l 
Login Name: joe In rea life . 
Directory: /home/ joe shell/bin/ksh 


On since. Aug 27 09:05 46 on term/con4 — 


1 hour Idle Time 


¥en have mail in Ivar /mai1/j0e ee 





In addition to the standard finger information, the -l 
option lists the user’s shell, time they have been idle, 
and status of their mailbox. 
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Use finger on one 
user 


Getting started 


You can also specify one user with finger. 


eo Binge poe 





This displays login information only for joe, if he’s 
logged in. It’s a little faster than finger, since you 
don’t have to read through many lines of information 
for other users. 
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Check on 
running 
processes 
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The who command only tells you the names of the 
users logged into your system. It doesn’t tell you what 
these people are doing. One of your routine system 
administration tasks should include running the ps 
command. ps gives you a list of your processes. 


o. BS 
PID TTY TIME COMMAND 


1234 ttyp4 e021 ps 
L2s7 ttyp4 Orel. ksh 





This tells you that you have two processes on your 
machine: the ps command (which you just typed), and 
ksh (the Korn shell). 


ps has many options. The one you are most interested 
in is ps -e. This command gives you a list of all 
processes on your system, including yours, other 
users’, and system processes that are always in the 
background. 
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Use more with ps If there is a large list of processes, they scroll by 
without stopping. You can use the more command to 
look at one screen at a time: 


$8 ps -e | more 





This says pipe (the vertical bar) the ps command’s 
output through the more program so you can look at 
one screen at a time. See Working with files and 
directories in this book for help using the more 
command. 


process ID terminal time process process 
number process is has been name 
running on running 
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process 
information 
for every user 










process 

information 
finger | for you 

login 

information 

for all users 











who 





login 
_| information 
who am i! for all users 









login 
information 
for you 


The progression of information requests 


Foreground and There are two types of processes: foreground and 
background background. You can see foreground processes on 
processes your screen. Background processes are hidden from 


your view and are ‘free running” in that you don't 
control them once they start. 


| processes 


| background | 
Ee a are hidden 





process |s 
visible on 
your screen 


foreground ee : 


Foreground and background processes 
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Kill a process 
using the ID 
number 


Use the kill 
command 


Getting started 


Foreground processes can usually be stopped with 
CTRL-C; background processes and some foreground 
ones can only be stopped by a kill command. 


One very important piece of information from ps is 
the process ID (PID) number. This unique number 
identifies a process. You can use the process ID 
number to terminate a process with the kill command. 
You might need to kill a process if it freezes, isn’t 
working properly, or if CTRL-C doesn’t work. 


Use the ps command to find the PID (look for the 
process name first in the ps list) then kill to cancel it. 
If your terminal is frozen, press ALT-functionkey to 
switch screens, then log in, ps and kill the bad 
process from there. 


The basic kill command works like this: 





NOTE: The kill command is as 
dangerous as it sounds. If you 
accidentally kill the wrong 
process, it’s gone. Use kill with 
extreme caution. 


You can only kill your own processes. If you want to 
kill someone else’s process, you must first log in as 
root. As root, you can kill any process you find 
running on your machine. 
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Sometimes you can’t kill a process by typing kill PID 
by itself. This usually happens if the process you are 
trying to kill is hung, or is asystem process. If you are 
having trouble killing a process, type the following 
kill command: 


S$ kill -9 PID 





The -9 guarantees that the process will die. 
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Checking on disk usage 


Check on disk 
usage for a 
directory 


Check on fotal 
disk usage for a 
directory 


Getting started 


You should keep tabs on the amount of disk space you 
and other people use. If you notice that your hard disk 
is filling up rapidly, you should check the space used 
by each person. You do this with the du (disk usage) 
command. It shows you how space is used in a 
directory branch, including the total for that directory 
(in 512 byte blocks) and all its subdirectories. 


s du eos — |. 
164. /nome/test 

756 ney ee te 

ee 





This example shows disk usage for Joe’s home 
directory (/home/joe). The numbers before each 
directory name are the number of blocks each 
directory uses. A block is equal to 512 bytes. You can 
look at only the total for this directory by typing du - 
s, or the size for all files with du -a. 
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According to du, joe is using 5052 blocks of disk space, 
or 2.5 Mb. The following table shows how blocks, 
kilobytes, and megabytes relate. 


Blocks Exact size Approximate size 
a foswe 


500 KB 0.5 MB 


1,000 KB 1 MB 
200,000 | 102,400,000 bytes|) 100 MB 





Use df fo check You can also use the df command to check the status 
the status of a of your disks. The -k option with df lists the total 
disk space available on your disks, amount of space used, 


amount of space left, percentage of disk used, and the 
mount point. 


S) <Gt ak | | 
Filesystem kbytes used avail capacity mounted on) 


/dev/dsk/c6éd0sl1 90112 65256 24856 723 
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Checking on print jobs 


Use Ipstat to You can check the status of every job waiting to print 
check on print on your computer using Ipstat -o. 
jobs 


5  [pslak 6 


Rank Owner sob Files Total Size 


active joe 145. mywork 12456 bytes a 





Ipstat without any options shows only your jobs 
waiting to print on the default printer. 


Check the printing chapter later in this book for more 
information on printing. 
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Understanding the UNIX shells 


What is a shell? The shell interprets what you type and acts on it, 
generally by finding and running a program. 


Your default shell is defined in a file called 
/etc/passwd. Each time you log in, the login command 
reads your line in /etc/passwd and starts the shell for 
you. Youcan also change shells temporarily, after you 
log in, by typing the shell’s name (sh, csh, or ksh). 
CTRL-D ends your current shell, either going back to 
your login shell or ending a login session altogether. 


The /etc/passwd file contains information about users 
who are allowed to login to your computer, including 
their login shell. Here is a sample line from 
/etc/passwd: 


user name login shell 


/joe 300 1-Joe Jones Eng /home/joe /bin/ksh 





For more information about /etc/passwd, see Editing 
system files, later in this book. 
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What are the You can choose from 5 shells. 


different shells? 


/bin/sh historically, the standard AT&T 
(Bourne) shell 

/bin/csh C shell commonly used by 
programmers and Berkeley 
enthusiasts 
Korn shell, compatible with the 
Bourne shell, includes many C shell 
features 


/usr/lib/rsh restricted shell, ignores most 
commands 


/bin/jsh adds job control functions to sh 





The Bourne shell (sh) is the standard shell; most other 


What's the shells were developed from it: rsh is a restriced subset 

difference of sh commands, jsh adds job control functions to sh 

between the commands, and ksh contains the commands of sh and 

shells? jsh, plus many other features. The Korn shell (ksh) is 
the default Amiga UNIX shell and the one we 
recommend. 


The C shell (csh) is a different type of shell; it’s based 
on the Berkeley UNIX system and is not compatible 
with sh. However, csh does use some of the same 
commands as ksh. 
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What's best 
shell? 
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csh and ksh use different startup files and syntax for 
certain commands. It’s important that you follow the 
directions for your shell, particularly when doing, 
comand line editing, using the alias command, or 
setting shell variables. 





How shells are related: csh includes some features from all 
the standard shells 


We recommend the Korn shell because it is 
compatible with all Bourne shell functions and 
provides some C shell features. Some of its 
convenient enhancements include aliases, command 
history, command line editing, and job control. See 
the reference section on login shells in the UNIx 
command reference chapter for more information. 
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Restricting user You can use the restricted shell (rsh) to limit the 
accounts with things a user can do on your system. The restricted 
/bin/rsh shell prevents a user from: 


¢ changing out of his home directory (thereby 
getting files other than his own) 


¢ changing the PATH variable (thereby getting at 
commands that have been hidden from him) 


¢ using a command that contains a / (slash) 


e redirecting input and output 


It takes more The restricted shell alone isn’t enough to prevent 

than just rsh users from getting around on your computer. In fact, 
it’s quite simple to break out of a restricted shell 
unless you set up a complete restricted environment. 
This environment should include: 


¢ aspecial bin directory with limited commands 
(ones that don’t allow you to issue shell 
commands that override rsh) 


¢ aspecial .profile and PATH for restricted users 


e an editor that does not let you execute shell 
commands 


If you don’t set up the restricted path and command 
directory appropriately, anrsh user could simply type 
a standard command and use its features to break 
your security. 


The restricted shell, properly implemented, is enough 
to contain all but the most experienced users, so you 
can let students, beginners, and children play with 
your computer without causing any damage. 
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However, it is extremely difficult to devise security 
mechanisms that are completely foolproof against 
UNIX experts. 


Getting started 


Geiting help from the man pages 


Using the man pages 





The Amiga UNIX man pages are an online reference manual. The man 
pages are stored in a number of directories under /usr/man. You can 
check these directories for a list of man page topics. After formatting a 
man page, the man page is saved in /usr/catman, so it displays faster 
the next time you request it. 


Man page commands Moving around a man page 


man topic Displays man SPACE BAR Move forward one 
pages for topic. screen 

man man Displaysaman | RETURN Move forward one 
page that line 


describes how to 


use the man Move back one 


pages. screen 
apropos word Search for man Quit 
pages that 


include word. 


whatis topic Displays a short 
description of 
topic, if a man 
page exists for 
topic. 








se6pd upw 


au} Woy djey Guiyjes 





Getting help from the man pages 


What are the The UNIX man (manual) pages are a complete on-line 

UNIX man reference to the system commands. To use the man 

pages? pages, you specify the command you are looking for, 
then scroll through the documentation as it is 
displayed. 


This section shows you how to select a man page and 
how to read the man pages. 


Request a man Suppose you want to see how to use the ls command. 

page Instead of reading this book, you could read a 
summary of Is right on your computer. Here’s how to 
get the man page for Is: 





In fact, this is how you get a man page for any 
command. You type man followed by the command 
name. If you don’t know the name of the command, 
see Using apropos to search for man page topics later 
in this chapter. 
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Move around in 
a man page 


40 


Moving around in a man page is just as easy as 
requesting one. All man pages are displayed using 
the more command. more lets you step through 
large files, one screen at a time. Here’s a brief 
summary of the commands you need to move around 
in the man pages: 


What does it do? 


SPACE BAR move forward one screen 
RETURN move forward one line 
move back one screen 


quit, return to shell prompt 





get online help for more 


You can also specify the exact number of lines you 
want to move forward by typing a number before 


pressing RETURN. 
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Reading a man Every man page uses the same basic layout: 


NAME command name and summary 
SYNOPSIS how to use the command (1 to 3 


page 


lines) 
DESCRIPTION explains options and their effects 


examples shows how to use some of the 
options 





You can also type man man to get instructions for 
using the man pages. 


Categorizing the The man pages are grouped by the type of 

man pages information they contain: user commands, system 
maintenance commands, etc. For every group of man 
page commands, there is a corresponding AT&T 
reference manual of the same name. The AT&T 
reference manuals have the same information as the 
man pages. The title on each man page tells you 
which section (group) the command belongs to and the 
section number. 


section reference manual 
number section name 
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Different 
categories of 
man page 
information 


Where are the 
man pages 
stored? 


Using apropos to 
search for man 
page topics 
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The following table summarizes the man page 
categories. 


Category | Type of information 


1 user and system administration 
commands 


system calls 
library calls 
file formats 
miscellaneous 
games 

special files 


system maintenance procedures 





The man pages are stored in a number of directories 
under /usr/man (gl through g8). If you want to see a 
list of man page commands for any section described 
above, check its directory. 


There may be times when you want to find all man 
pages that reference a particular command or word. 
You can use a command called apropos to search the 
man page directories for a keyword. 


Getting help from the man pages 


apropos who» 





In the above example, apropos found every man page 
that makes reference to the who command or to the 
word who. The command name and section number 
that apropos displays come from the man page 
description. 


command manpage command 
name section description 


risers” fy wher a ithe A 
a a 
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Using whatis to 
get a command 
description 


Speeding up the 
man pages 


Using catman to 
preformat the 
man pages 
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The whatis command displays three pieces of 
information about any command you specify: 


* command name 
* command section 


e 1 line description 


S whatis who 


who (1) -who is on the system 





The first time you use a man page, it takes a few 
seconds for man to format it. The second time you use 
the same man page, it appears on your screen almost 
instantly. This is because man saves the formatted 
version and uses it in the future. 


To skip the reformatting process for every new man 
page, you can format them all in advance using the 
catman command. The drawbacks to catman are 
that it creates about 15 megabytes of formatted man 
pages (in addition to the 5 Megabytes of unformatted 
man pages) and it takes about three hours to process. 


Your formatted man pages gradually grow as you 
request more man pages. You can periodically 
remove these files from /usrcatman to free disk space; 
keep the ones you read most often. 
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Troubleshooting 


Problem 


Can’t find help 
on a topic 


Don’t know the 
command you 
want 


You want to read 
an earlier page 
of the man page 


Takes too long 
for man page to 
appear 


Solution 


Be sure you type lower or uppercase characters where 
appropriate. UNIX is case sensitive. 


Check the files in /usr/man/g1, /usr/man/g1A or any 
other /usr/man subdirectory. If the command is not 
listed in one of these directories, there is no man page 
for it. 


Use apropos to search for keywords. For example, if 
you want to list files, but don’t know the list 
command, type apropos list 


man pages are displayed through more. Use b to go 
backwards, RETURN to advance one line, or SPACE 
BAR to advance a page. 


Use the catman comand to preformat all the man 
pages. 


Run man for all the commands you use regularly; this 
creates a fast formatted version of those man pages. 
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Getting help from the man pages 


Working with files and directories 


File commands Directory commands 





mv Move or rename files d Move to your home 
rm Delete files d.. Move up one directory 
chmod Change file permission level 
cat Display file contents pwd Show your current 
more Display a page at a tim directory 
tail Display last 10 lines of | Mkdir Make a new directory 
file mdir Remove empty directory — 
head __sDisplay first 10 lines o hmod Change directory 
file permissions 
find Search for a file List directories contents 





File and directory concepts 





File types Directories, devices, executable programs, text, data 


Wildcards Character substitutions. * for many characters, ? for 
one character in a file name 


Permissions Youcan give people the authority to read, write, or 
execute (rwx) your files and directories. Assign 
permissions to yourself (u), people in your group (g), | 
others (0), or all (a) people. Use chmod to change the : 
permissions. For example, chmod a+trw lets anyone 
read and write a file. i 
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Working with files and directories 


Why should you 
read this 
chapter? 


Your understanding of files and directories is critical 
to working with UNIX. Just about everything you do 
with UNIX requires at least one file. You have to know 
how to manipulate these files by looking at, copying, 
moving, renaming, and deleting them. 


Files are all stored in directories. Some of these 
directories hold system files, some hold your files, and 
some hold other users’ files. You have to be able to 
move around these directories, create new ones, and 
remove old ones to work with UNIX files. 


This chapter gives you the basic information you need 
to work with UNIX files and directories. 
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Working with directories 


The root The UNIX directory structure resembles a pyramid. 
directory 





























Directory structure grows downward into more directories 
and files 


There is a "peak" or top directory called the root, and 
referred to in UNIX as a slash (/). Everything else 
branches down and out from this peak. 
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What is a path? To move through the branches, you must specify a 
path. The path is a road map to the directory you 
want. 


UO 
_ Tae 


er 


cd / moves to No matter where you are, you can always switch to 
the root directory the root directory by typing ed /. (ed stands for 
change directory). 
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Your home 
directory 


pwd to see 
where you are 


90 


“ST you are here 
cy 
/ 
SS 
SI 
home 
ES SS 
3, | F 
mary 











apy 
O 

a |. 
stuff 





cd 
move to your home 


cd.. 
move up one level 


cd stuff 
move down one level 


cd /home/mary 
move directly fo a 
directory 


cd ../joe 
move up, then down 


Different ways of using cd fo move around 


When you first log in, you are in your home directory. 
Your home directory is where you keep all your 


personal files. Your home directory also contains some 
special configuration files that your shell reads when 
you log in. 


You can check that you are in your home directory by 
using the pwd (print working directory) command. 
pwd always shows your current location in the 
directory tree. 


S pwd 


/home/ joe 
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cd fo return You can always return to your home directory from 
home anywhere by typing cd by itself. 


ee pwd to verify the 


MOVve 


6 6d 
S pwd | 
/home/mydirectory — 





You are here 


pwd /nome/joe 
cd. /Nnome/joe 
Cli <x /home 

cd f/f 
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What are the 
standard 
directories? 
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System V Release 4 comes with many default 
directories. These start with 12 directories off root, 
then many others below them. 





rai 


Ss 
Ss 
ZAIN 


ae CL 
4 
bia ee Ss ome 


sy 

O 

stand lost & =. Ea ee sbin 
— ay Sy 

C Oo 

oy C4 

es unix usr var 


root directory contains 12 standard directories and the 
UNIX kernel 

























You can move into any one of these directories. If you 
want to move into the /etc directory, type ed /ete. 





Each default directory serves a specific purpose. The 
table on the following page lists the directory name 
and its purpose. 
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What do the 





standard 
7 
bin user commands 
etc system configuration files 
lost+found file system repairs 
sbin system level commands 
home users’ home directories 
mnt temporary mount point 
tmp temporary files for the system 
usr more commands and system files 
dev all the device files 
proc mount point for proc’ file system 
var system configuration files 
Create You can create your own directories by using the 
directories make directory command (mkdir). If you want to 


create a directory off your home directory, ed to your 
home directory, then type the mkdir command. 


S mkdir directory 
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Remove 
directories 


04 


You can change from the current directory into the 
new directory by using ed. 


S$ cd directoryname 





You can remove a directory just as easily as you 
created one. The only catch is that the directory must 
be empty. If you try to remove a directory that still 
has files or subdirectories in it, rmdir tells you that 
the directory is not empty. You have to remove 
everything from a directory before you can remove the 
directory itself. 


$ .xmdir. directory 
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Understanding the different UNIX file types 


How many types There are three basic UNIX file types: directory, plain, 
of files are there? and special. You can use these files to represent many 
different things, including: 


e directories 
store pointers to other files 


e devices 
files that communicate with disk drives, 
terminals, etc 


¢ executables 
programs that you can run 


e text or data 
contain code, characters, and data 


° special 
files that are devices 
Check the file You can use the file command to check a file’s type. 
type 


8 file /etc/passwd 


fetc/passwd: aSeil Eext 





The file command won’t work on files unless you have 
permission to read them. If you try to use file on a file 
that you don’t have permission to read, the file 
command responds with an error message. 


filename cannot open Permission denied 
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If you get this message, you are trying to look at an 
important file with restricted permissions. You can’t 
look at this file unless its owner lets you. 
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Listing files 


List your files 
alphabetically 


List one file 


The Is (list) command gives you a list of files in a 
directory. There are at least twenty options you can 
use with Is. We’re going to describe some of the more 
common options here, but you can use the manual 
pages (type man Is) to get information about other Is 


options. 


Is, without any options, lists the files in the current 
directory in alphabetical order by file name. 





Is with a file name shows you only that file (Gf it 
exists). Is with a directory name shows the files in 


that directory. 





pixie file = file 
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a a a 
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ae 
file 
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Other ways fo list You specify options for the ls command by typing a 
files space, a dash, and the option. 





Here’s a list of some useful Is options: 


What does it do? 


Display all files in the directory 
Show type, size, permissions, owner 
Display block size of each file 
Display in order by last change date 
Show time last used 

Reverse the sort order 





Combine Is You can combine some Is options to customize your 

options file list even further. You could combine the -a (all) 
and the -s (block size) options to list all files and their 
size in 512 byte blocks. 


current parent hidden regular 
directory  direcory file file 
1 level up 


2 .history 70 newfile 
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The best way to learn about the Is options is to try the 
ones we gave you, then experiment with different 
combinations. You can’t hurt anything by 
experimenting with Is. If you don’t have enough files 
in your directory, try listing the /usr/lib or /usr/public 
directories, then any directories under them. 
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Finding files 


Search for files 


Use * and ? to 
match patterns 
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The UNIX system has commands that search through 
directories for files. This section shows you how to: 


¢ substitute wildcard characters in file names 


e use the find command to locate files 


The shell lets you substitute characters in a file name 
with the asterisk (*) and the question mark (?), as well 
as other special characters. These characters are 
known as wildcards because they can represent any 
characters you want. 


The difference between the two is that the asterisk 
can substitute for any characters in a file name, but 
the question mark must substitute for exactly one 
character at a time. 


document | 
document? = docu* = document? 


document3 





Your home directory might contain 50 files. You only 
want to list document.1, document.2, and document.3. 
Here’s two ways the wildcard characters help you do 
this: 


S ls doc* * 


document 1 document 2 document 3. doc review 





A better way is to use a more exact search pattern. 
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Use the find 
command to 
locate files 


$ ls document ? © 


document.1 document 2 document. 3 2 





As you can see, the second method, using the question 
mark, is more specific than the asterisk method. You 
weren't looking for a document called doc.review, but 
because asterisks are a general substitution, you got 
it anyway. 


The find command, like many UNIX commands, is 
very powerful. You can use it to find any number of 
files, anywhere on your hard disk, in any directories 
that you are allowed to read. The power and 
flexibility of the find command also make it difficult 
to use. For this reason, we are going to show you the 
basics of using find to locate a file. If you want to 
experiment further with find, check the man pages 
(type man find) for more specific uses. 


The find command searches through every directory 
and every disk in your machine if you start from root. 
This takes a long time and could produce an 
overwhelming amount of information. Most of the 
time you will probably want to search for files starting 
in your home directory, or in a specific directory 
branch. In this case, find starts from the specified 
directory and searches through the directories that 
branch off it. 
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Find files in or 
below your 
home 


62 





find /nome/joe 
find can search any part of a directory tree 


Here’s the most basic use for the find command: 


find, starting all files named = and display 
in joe’s home filename them on the screen 
directory 


$ “find /home/ joe ~=name filename -print 
/home/joe/ filename 
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Looking at a file’s contents 


Display files You can look inside a text file without actually doing 
any work on it. This section gives you some options 
for looking at all or part of a file (top, bottom, or page 
by page). 


more head cat 


| 





- 
= 
= 
= 
= 
= | | 


tail 
Different commands look at all or part of a file 
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Display an entire Use the cat command to display the contents of one or 
file - cat more files. 


5S ‘Gat filename 


If you type cat filename, and the file does not exist, 
cat tells you that it can’t open the file. If you try to 
cat a file that you are not allowed to read, cat tells 
that you are denied permission. 


If you are not in the directory where the file is located, 
you must type the path to the file before the filename. 


S$ cat /users/home/joe/filename 
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Display a page 
at a time - more 


Large files scroll by quickly, leaving only the last 
screen of lines visible. Unless your file is very small, 
you miss the top and middle parts of it. The easiest 
way around this problem is to use one of the other 
commands described in this section. The hard way is 
to use CTRL-S to stop scrolling and CTRL-Q to restart 
it. 


The more command works like cat, except that it 
pauses after each screen and lets you move forward or 
backward. You press the space bar to continue on to 
the next screen. more shows the percent of the 
document you have read in the bottom left corner of 
the screen. 





more shows one page ai a time 
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$ more filename 


top of screen 


bottom of screen 
-more- 50% 





more options more has many other options for moving around the 
file. Some of these options are listed below. 


What does it do? 


SPACE BAR Move forward one screen 
RETURN Move forward one line 


Move back one screen 

Quit, return to shell prompt. 
Get online help 

find text pattern 





You can also specify the exact number of lines you 
want to move forward or back. For other options, 
check the more man pages. 
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Display the end The tail command displays the tail, or end, of a file. 
of a file - tail The tail command, in its simplest form, takes just a 
filename. 





By default, tail displays the last 10 lines of filename. 
You can also specify the number of lines you want to 
see by typing + or - number of lines. 





If you type a negative number, -3, tail shows the last 
three lines of the file. If you type a positive number, 
+3, tail starts the display at line 3. 


See the tail man pages for a complete list of tail 
options. 


Working with files and directories 67 


Display the The head command displays the head, or beginning, 
beginning of a of a file. The head command, in its simplest form, 
file - head takes just a filename. 


S head filename 





head displays the first 10 lines of filename. You can 
also specify the number of lines you want to see by 
typing minus and a number. 


S head -20 filename 





This example displays the first 20 lines of filename. 
You can specify any number of lines for head to 
display. 


See the head man pages for a complete list of head 
options. 
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Copying files 


Copy files The ep (copy) command lets you duplicate a file and 
give ita new name. Although you use ep exclusively 
for duplicating a file, it can actually achieve three 
different goals: 


¢ duplicate a file and give it a new name 


¢ duplicate a file and put it in a different directory 


e duplicate a file, put it in a different directory, 
and give it a new name. 





cp copies files to a new name or a new place 


You can also ep more than 1 file, by typing each 
filename or by using wildcards. 
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Same directory- The following example shows you how to duplicate a 
different name file. 


S$ cp sourcefile destinationfile 





The source file is the one that already exists, and the 
destination file is the duplicate you are creating. This 
example would put the new file in your current 
directory. 


NOTE: If the destination file already 
exists, cp overwrites it, 
destroying its original contents. 
Don’t be careless; if you 
accidentally copy the wrong 
direction you could destroy a file 


instead of copying it. 
Different Copying files to a new place is similar to the above 
directory - same example, except you must specify a destination 


name directory. 


$ cp sourcefile directory 
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Different This example shows you how to copy a file between 
directory - directories, giving the new file a different name. 
different name 





Copy several This example shows you how to copy several files 
files at once between directories. 





You use the move (mv) command to rename files or 
move them to a different place. 
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Renaming and moving files 


Rename files 





mv renames a file or moves it to a different place 


Unlike the ep command, mv does not create a 
duplicate of the first file. It replaces the first file with 
the new file, so you have a new file but not the old one. 


S mv filename newfilename 





NOTE: Ifthe new file already exists, mv 
overwrites it, destroying its 
original contents. 
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Move files to a You can use mv to move a file to a different directory. 

different mv does not create a duplicate file for the destination 

directory directory. It takes the original from the source 
directory and leaves nothing in its place. 


S$ mv filename directory/f1lename 





Move many files You can move multiple files to a new directory by 
at once listing more than one file after the mv command and 
before the directory name. 


Gwe Euicdene Fllenaned Fulenaned avegiory 
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Deleting files 


The rm 
command 
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You can delete files using the remove (rm) command. 


S rm filename 





Don't let the simplicity of this command fool you. It 
has the potential to do a lot of harm. You should 
double check the filename before using rm. You 
should be even more cautious when you delete files 
using wildcard characters. You could end up deleting 
more files than you wanted to. 


rm does not ask you to confirm that you want to 
delete the files, nor does it tell you which files it 
deleted. You might want to use rm -i instead; it asks 
if you are sure before deleting each file. 


NOTE: If you remove an important file, 
there is no way to get it back. 
Don’t be careless with the rm 
command. 
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Protecting your files from other users 


If you check your directory using Is -l you see lines of 
information that include several different groups of 
data. 





File attributes These are the file attributes. The following figure 
shows you what each attribute means. 


file file owner group file date last 
type permissions | size modified 





Is -l shows everything about a file 


Attribute What does it mean? 


file type Regular(-),dir(d), block(b),char(c), 
pipe(p), or link (1) 


permissions Who can use the file and how 
owner Person who created the file 

group ID Group to which owner belongs 

file size Space it takes up on your disk 

last modified Date and time file was last changed 
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Change file 
permissions 
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You can prevent other users from reading, writing, or 
executing your files. You do this by changing the 
permissions associated with a file or directory. 


The letters from position 2 to 10 at each line indicate 
the file permissions. Notice that there are three 
croups of three characters (rwx rwx rwx). Each group 
of three letter refers to specific types of users. 


owner group other 
permissions permissions permissions 





Permissions can be different for you, your group, and all 
others 


The above example says that the owner has read, 
write, and execute permission for this file. People in 
the owner’s group can read and execute it, and 
everyone else can only read it. There are other less 
common letters you can substitute here, but they are 
generally used by programmers. 


Symbol 


read the file 


write the file (change it) 
execute, or run, the file 
not available 
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Owner Group Other 


writer 


documentation 
department 


Your world is you, your group, and everybody else 


Working with files and directories 
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Change 
permissions 
using chmod 


Basic use for 
chmod 
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You can change the permissions for any file you own. 
You can make it so that: 


e you are the only person who can change a file, 
but everyone can read it (-rw-r--r--) 


¢ only you and people in your group can change or 
use a file (-rw-rw----) 


¢ nobody but you can even look at your file 
(Teasers ) 


e any other combination you can think of. 
You change file permissions by adding or removing an 


r, w, or x. You add or remove an rr, w, and x using the 
chmod command. 


The following example shows the basic use for 
chmod. 


for user, group, and other (ugo) 
add (4) 
read, write, execute (rwx) 


to filename 


S chmod ugotrwx filename 
> “dis. ad. 
-rwxrwxrwx 1 thomas grpl 7290 Apr 21 14:36 filename 





Is -l then shows the changed permissions. 


Working with files and directories 


The following is another example of chmod. 


from others (o) 
subtract (-) 
read, write, execute (rwx) 


for filename 


Ss chmod | o- -CwWx Filename | 





Is -1 then shows the changed permissions. 


As you can see from the two examples, chmod adds or 
subtracts privileges from a file. All you have to do is 
specify any combination of options in the form of 
people action permission. 


You do not put a space between the 3 components of 
the permissions argument. 
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Using chmod on 
directories 


add or subtract 
user, Qroup permissions 
other, all read, write,execute 


BS chmod ugoat-rwx filename 


people action permission 





You can use chmod to restrict your directories as 
well. You can make it so other users can’t look in, add 
files to, remove files from, or use files in you 
directories. chmod for a directory works exactly like 
chmod for files, except you specify a directory name. 
The directory permissions only affect operations on 
the directory, not the files in the directory. 


Symbol Gives group permission to 


list directory (read names in it) 


add files to it or delete them (modify) 
use files in the directory or execute 
them (search the directory) 
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Troubleshooting 


Problem 


Can’t change 
into a directory 


Can’t delete a 
directory 


Can’t delete a 
file 


Can’t list a 
directory 


Can’t display, 
move, rename, 
or copy a file 


Solution 


Be sure you are typing the directory path correctly. 


You may not have permission to read or execute that 
directory. 


Directory still has files or subdirectories in it. 


You may not have permission to write or execute the 
parent directory of the directory you want to delete. 


You may not have permission to write or execute the 
directory where the file is. 


You may not have read access to the directory. 


You may not have read access to the file. 
You may not have write permission for the file. 


You may not have permission to read, write or execute 
the directory you are now in. 


You may not have used the correct path or the file 
might be empty. 


Working with files and directories 81 


Problem 


Accidentally 
copy over or 
delete an 
existing file 


Can't find a file 
using find 


Find lists too 
many files 


Which file was 
used last? 


Copy an entire 
directory tree 
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Solution 


No way to get it back. Be extremely careful when 
copying, moving and deleting files! 


The file may not be in the path you specified. 


The file may be in a directory that you can’t read. 


Modify your search path or wildcard pattern to 
narrow the search. 


Use Is -It or Is -alt to list the contents of a directory in 
order by date changed. 


Use Is -altu to list files in the order in which they 
were last accessed for any reason. 


Use the ep command with the -r option. 


Working with files and directories 





Printing 


Buju 


Printing terms and concepts 












Print service Amiga UNIX uses the standard UNIX Ip print service 
commands 


lIpsched lp program that spools print jobs and schedules 
them for printing 

Conversion 

interface Program through which files pass on their way to the 
printer. Used to convert text to Postscript, for 
example, or to send special characters to a printer 


Default printer Printer to which you automatically print 
Print job Any file that is queued and waiting to print 


Print commands Conversion interfaces 











Conversion interfaces are located 
in /usr/spool/lp/model 


Ip Command that sends 
a file to the default 
printer 


Ipadmin Command you use to 






Available interfaces: 
postscript 
standard 






Ipstat Command you use to 


disable Stop printing 

enable _ Restart the printer 

cancel Kall a print job 

reject Do not let jobs into 
print queue 

accept Allow jobs into the 
print queue 





Printing 


Why should you 
read this 
chapter? 


Using a printer 


Set up a printer 


Printing 


Most of the effort involved in printing is setting up the 
Ip (line printer) print service. This chapter shows you 
how to set up the lp print service and how to print 
files. 


You (and other people who use your computer) can: 


¢ print a file 
e list the jobs waiting to print 


e cancel a print job 


The important printer configuration steps you need to 
take are: 


e make sure Ipsched is running in the 
background 


e physically connect the printer to a serial or 
parallel port 


e login as root 


e check /etc/inittab to be sure the port is not being 
used for logins 


* name your printer 
e identify the printer’s device name 


e choose a conversion interface depending on the 
type of printer you have 
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You use the lp command to send a file to a print queue 
(and ultimately a printer). lp takes your file and puts 
it in the queue for the print scheduler (Ipsched). One 
by one, lpsched sends the files to the printer, until 
there are no more left in the queue. 


reject disable 
stops print stops print 
jobs here jobs here 





Ip 
starts Q 
print job | 


accept enable 


Understanding the UNIx print process 
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Using lpadmin to add a printer 


Define your 
printer 


Printing 


Before you can run Ip, you need to define your printer. 
You do this by using the lpadmin command. 


You use lpadmin to add a printer connected to your 
system, change an existing one, or change the default 
printer. The following example shows the basic 
format for lpadmin. 


_#ipadmin -p name -v device -1 interface -o nobann 





name what users call this printer 


device device name (/dev/par, 
/dev/term/ser, or /dev/term/ql00 
through /dev/term/ql06 if you are 
using a ql card. The bottom port 
on the ql card is /dev/term/ql00 
and the top port on the ql card is 
/dev/term/ql06) 


interface program that controls files for 
printer (standard, PostScript, or 
any program in 
/var/spool/lp/model) 


nobanner allows you to print without a 
banner page if you choose 
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enable and 
accept the new 
printer 


86 





The following example defines a PostScript printer on 
the main serial port. 


printer main serial 
name port 


# lpadmin -p ps -v /dev/term/ser 


-i (var /Sp OO -o nobanner a 


PostScript all users to print 
interface without banner 


page 


To complete the process of adding a printer, use the 
enable and accept commands. These tell lp and 
Ipsched to accept print requests from users, and to 
print these requests. 


# enable printername 


| # accept printername 





The default printer is the one where you want your 
files to print when you don’t specify a printer. 


Printing 


Use lpadmin to 
name your 
default printer 


Send a print job 
to a different 
printer 


Special note for 
serial printers 


Printing 


In the previous example of lpadmin, you defined a 
printer and an interface but did not tell Ip to assume 
that print jobs automatically go to this printer. Ip 
won't know what printer to use unless you specify one 
with each lp command or assign a default printer that 
you use most often. 


To define your default printer, you need to run the 
lpadmin command again with the -d option. 


#  lpadmin -d printername 





The printer printername will be your destination 
printer until you change it or specify another one. You 
can change it at any time by running lpadmin -d 
with another printer name. You can change your 
default printer for a file by typing the following option 
when you print the file. 


8 i -d printername filename 





If you connect the printer to a serial port, you should 
check /etc/inittab. If you have a ser line in /etc/inittab, 
be sure it is off so you can print to it. The ser port 
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inittab line usually has its getty turned off; it is 
switched to respawn if the port is used for a dumb 


terminal. 


ser0:23:0ff /etc/getty term/ser i tain pore 





Change an Use Ipadmin to change the settings for existing 

existing printer printers. You can change the device name and the 
interface, or either one, by identifying the printer and 
typing the new setting. 


change the 
printer, device, change the 
and interface default printer 


| # lpadmin 
 # lpadmin 


_# lpadmin 
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“p priantername —y device =1 interface — 
“G printermene | 
RP PS -8 Gevice<« =. st 
PO PS -1 interface = =... 


change the eee the 


interface 


Printing 


Delete a printer 


Printing 


To delete a printer from the lp system, use the 
Ipadmin -x option. 


# ipadmin ae. printername 
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Printing a file 


Use the Ip 
command to 
print a file 


Print to another 
printer 
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The lp command starts the printing process. After 
you configure your printer with lpadmin, you can type 
lp filename to print a file. 


S lp filename 





If you want to use a printer other than your default, 
you need to tell lp which printer to use. 


$ 1p -d printername filename 





You can check the default printer name by typing 
Ipstat -p. 


S$ lpstat —p 


printer name is idle enabled since thur sep a 
12:25:37 ‘EDT 1990. available 2 :  . 





Printing 
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Ip options Sometimes you have to specify options to the Ip 
command. Suppose your default printer is a 
PostScript printer with a PostScript interface. This 
interface normally converts text files to PostScript, 
but you might want to print troff or already- 
formatted PostScript files on this printer. The 
following examples illustrate how different Ip options 
print different types of files. 


Print a PostScript 





The -o postscript option tells the PostScript interface 
not to reformat the file, because it’s already in 


PostScript. 
Print a troff file on De ee, es 
printer 0 





This command uses troff to format a text file, then 
converts it to PostScript and sends it to the printer as 
a postscript file. 


Print a text file 
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Print without the 
banner page 
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This command prints the file using the interface for 
the default printer. If a text file is sent to your 
PostScript printer, it is converted to PostScript. Ifa 
troff or PostScript file is sent without options, it will 
not print properly, because the interface will try to 
convert it again. 


The banner page is the first page to come out of the 
printer. It contains the following information about 
your job: 


e who requested the job and from where 
e id 

¢ printer name 

e date and time 


Use Ip -o nobanner to print your file without the 
banner page. 





When you issue the lp command, the file goes to a 
print queue where it waits its turn to print. You can 
check on print jobs that are waiting in the queue by 
using Ipstat. 


Printing 


Checking on print jobs 


Use lpstat and 
lpstat -o 


lpstat options 


Printing 


Ipstat shows only your print jobs. lpstat -o shows 
you all the print jobs in the queue, including the order 
in which they are scheduled to print. 


date & time printer 
submitted 


Postscript-1164 lou 122 May 24 09.28 on pri 


Postscript -1165 





show print jobs for specific user 
show information about all printers 


tells you if lpsched is running 
show the device for this printer 
show status for a specific printer 
identify the current default printer 
show print jobs for all users 
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Cancel a print Use the cancel command to remove a print job from 
job the queue. You can only cancel your own print jobs, 
unless you log in as root. 


cancel: Fd 
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Stopping the Ip print service 


Prevent users 
from printing 


Printing 


Two commands let you stop users from printing, 
reject and disable. You must log in as root or lp to 
use these commands, or to restart lpsched. reject 
prevents the print queue from accepting jobs. 
disable prevents the printer from printing jobs that 
are already in the queue. 


reject disable 
stops print stops print 


jobs here jobs here 


———>(aueve ) —r Printer 


When you disable the printer, lpsched will still 
queue your files, but they won't go to the printer until 
you enable printing again. If you reject the printer, 
Ipsched will tell you that it can’t print your file. 
reject prevents the queue from accepting any new 
print jobs. Use disable if you need to turn a printer 
off for a short period of time, but don’t want to panic 
users who depend on the printer. Use reject if you 
want users to know that printing doesn’t work. You 
can use -r message with reject and disable. Type 
accept or reject -r followed by a messge that lets 
users know why printing does not work. 


95 


If your file does 
not print: 
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Use the enable command to start sending print jobs 
to the printer again. 


Use the accept command to start accepting new print 
jobs again. 


If the file doesn’t print, and you are sure your Amiga 
and printer are configured properly, lpsched might 
not be running. Check it using Ipstat -r. To turn 
lIpsched on, type /usr/lib/lp/Ipsched. If lpsched 
fails to start or quits, you should check /var/spool/lp 
for a file called SCHEDLOCK. Remove this file then 
run /usr/lib/lp/lpsched again. 


Also, type accept printername and enable 
printername to make sure the queue and printer are 
ready to process jobs, and make sure the default 
printer is the one you are trying to use. 


Printing 


Troubleshooting 


Problem 


Can’t print 


Files aren’t 
accepted for 
printing 


lpsched 
stopped working 


Printing 


Solution 


Use Ipstat to see if the file is in the print queue. 


Check your mail. lp sends print errors to you through 


mail. 


lIpsched is accepting print jobs, but not printing 
them. Type enable to start printing again. 


Use Ipsched -r to see if the scheduler is running. 
Type lpsched to turn the print scheduler on. 


Type accept to start accepting print jobs. 


Check /var/spool/Ip for a file called SCHEDLOCK. 


Remove the file and restart /usr/lib/Ip/Ipsched. 
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Problem 


Your PostScript 
file prints 
numbers instead 
of text 


lpstat says it is 
printing, but 
nothing happens 


lp is unable to 
read the file 


98 


Solution 


Tell the interface not to convert it. 


lp <o postscript filename 





Turn the printer off, wait a minute, turn it back on. 


disable the printer, reject it, turn it off, wait, turn it 
back on, accept it, and enable it. 


Cancel the print job and print it again. 


Change the file permissions for your directory. Ip 
can’t print your file if "others" don’t have execute 
permission in your current directory. 


Read your mail. It might have an error message that 
explains the problem 


Printing 


Using the vi editor 


Special keys 





ESC cancel insert mode 
CTRL-L redraw screen 
CTRL-D scroll down 
CTRL-U scroll up 


Insert and append 


Delete text 





x delete character 
dw delete word 

dd ___ delete line 

ndd_ delete n lines 


Undo and repeat 





i insert text 
Oo add blank line 0 


Quit and save 






<q! = quit without saving 
:wq_ save and quit a file 
:w save your work 


Change text 


cw change word 
ce erase a line and insert 
C change to end of line 


u undo last change 
U undo changes to line 
. (dot) repeat last change 


Move and copy 


dds cut 


yy yank (copy) 
p paste below 








Search 

/ search 

n repeat search 
N reverse search 


Move in a file 





to next word 


to end of line 
to the last line 


back to beginning of line 


move to line number n 





JOJIPS IA Ou} Buisy 





Using the vi editor 


Why should you This chapter provides a brief overview of basic vi 
read this (visual text editor) editing commands. To find out 
chapter? more about vi’s advanced commands, read the vi man 


pages or a vi reference book that you can find in your 
local bookstore. 


This chapter shows you how to use vi to: 


Using the vi editor 


open and view text files 
insert text 
move within a file 


change or delete characters, words, lines, and 
blocks of text 


correct mistakes by “undoing” them 
edit text 

repeat command sequences 

move and copy blocks of text 


search for a word or phrase 


99 


Special features 


Switch between 
modes 


Use ESC to end 
insert mode 


Use RETURN key 
at the end of a 
line 
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This section describes vi’s special features, including 
the fact that it is a modal program, doesn’t 
automatically wrap text, and is case-sensitive. 


The vi editor has a unique editing feature; keys 
perform differently depending upon what "mode" 
you're in. vi works in three modes: basic command 
mode (keys perform editing tasks), file command 
mode (save and quit), and insert mode (keys insert 
text characters). 


Use the ESC key to end insert mode and return to 
command mode. 


When you first enter vi, you’re in command mode. 
You can press an insert command key (such as i) to 
begin typing text. When you want to edit your work 
(to change, add, or delete a word), press ESC to end 
insert mode and return to command mode. While 
you're in command mode, the keys on your keyboard 
issue commands; you can’t enter text until you press a 
insert command key (a, A, i, I, o, O). 


If you forget which mode youre in, just press ESC to 
return to command mode, then start again. 


The vi editor doesn’t automatically wrap text, so you 
must press RETURN when you reach the end of a line 
on your screen. 


Using the vi editor 


Sef wrapmargin 


Colon 
commands 


vi is case 
sensitive 


CTRL-L to redraw 
screen 


Using the vi editor 


However, you can tell the editor to automatically 
insert RETURNSs near the end of each line by typing 
sset wm=10 (set wrapmargin to 10 characters from 
the right) while in command mode. The :set 
command doesn’t reformat the rest of the paragraph; 
it simply breaks lines. 


You also use RETURN to complete certain commands. 
Whenever you use a colon command (:set, :w, :q, :wq, 
<q!), you must press RETURN to execute it. 


Because some commands use the same letter, vi is 
case-sensitive. For example, if the instructions tell 
you to press r, press the key marked R. If the 
instructions tell you to press R, press the SHIFT key 
and the R key together. 


Use CTRL-L to redraw your screen if it becomes 
garbled. You may need to use CTRL-L if someone 
tries to use the talk command while youre typing, or 
if other system messages come through to your screen. 
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Starting and ending the vi editor 


Start vi To start the vi editor, type vi and the name of your 
file. If you don’t include a filename, vi starts editing 
in an unnamed buffer; you can’t save the file until you 
name it. (Refer to the Troubleshooting section for 
directions on saving an unnamed file.) 


Save and quit Here’s a list of the save and quit commands. 
commands Remember to press RETURN after typing any colon 
command. 


save your work 
quit vi 


save your work and quit vi 

quit without saving your work | 
read another file into your current file 
same as :wq; save and quit : 





You'll see the colon commands at the bottom of your 
screen, but don’t worry; they won't appear in your text 


file. 

Be careful with Be careful with the :q! (quit without saving) 

:q! command; it quits vi without saving any changes you 
made to the file. 
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Save your work Use the :w (write) command to save your work from 
occasionally time to time, just in case something happens to your 
system. 
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Moving around in a file 


Why is your 
cursor 
important? 


Cursor 
movement key 
commands 
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This section explains how to move your cursor around 
in a file. Moving the cursor is important because you 
need to put it in the right spot before performing a 
command or typing text. You can move it ahead or 
back by lines, words, or characters. 


Here’s a list of the most frequently used cursor 
movement keys. Remember to press ESC if you're in 
insert mode before using these commands or you will 
type the characters into your file. 


Movement 


left 

down 

up 

right 

forward a word 


back a word 


0 (zero) beginning of line 

$ (dollar sign) | end of line 

CTRL-D scroll down 

CTRL-U scroll up 

nG nth line in the file (for example, 1G for 
the first line of the file) 

G last line in file 


Using the vi editor 


Using arrow keys You can use the arrow keys to move the cursor around 
while staying in insert mode. You don’t need to press 
ESC before using the arrow keys; they’re not 
considered command keys, but rather special function 
keys within insert mode. 
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Adding text 


Inserting and You add new text before the cursor when you "insert" 
appending text text. When you ‘append text, you add new text after 
the cursor. 
| adds text a adds text after 


before the cursor the cursor 


|__| 
word 


Add text before or after the cursor 


Insert and Here’s a list of insert and append commands. 


append 
What does it do? 


commands 
add text after the cursor 
add text at the end of a line 
insert text before the cursor 


insert text at the beginning of a line 
insert a new line below the current 
line 

insert a new line above the current 
line 





Insert blank lines To insert a blank line, press 0 (open a line); the blank 


line appears below the cursor line. Press O (SHIFT- 
QO) to place the blank line above the cursor line. 
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Deleting text 


Delete You can delete single characters, words, lines, or 
commands blocks of text. Here’s a list of delete commands. 


delete character 
delete word 


delete line 

delete n lines (where n is a number) 
delete to end of line 

delete to the bottom of the screen 





Delete a single To delete a single character, move the cursor to the 
character (x) character and press x. 


Delete word (dw) The dw (delete word) command deletes a word. Move 
the cursor to the beginning of a word and press dw. If 
you place the cursor in the middle of a word, the text 
from the cursor to the end of the word disappears. 


If you accidentally place the cursor on the space before 
the word, the editor deletes the space first. You have 
to press dw again to delete the word. vi considers the 
space as a word. 
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Delete a line (dd) 


Delete several 
lines (ndd) 


Delete to end of 
line (D) 


Delete to end of 
screen 
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Deleting a line is very simple. Place the cursor 
anywhere on the line you want to delete and press dd. 


Use the ndd command to delete more than one line. 
For example, to delete a block of 20 lines, place the 
cursor on the first line of the block and press 20dd. 
(dd without a number assumes you want to delete 1 
line.) 


If you want to delete the rest of a line, press D 
(SHIFT-D). This command deletes text from the 
cursor to the end of the line. 


To delete the rest of the lines on your screen, move the 
cursor to the first line you want to delete and press 
dL. The editor deletes all the lines to the bottom of 
the screen and automatically moves the remaining 
lines in the file up to fill the current screen. 
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Temporary buffer Any text you delete is put in a temporary holding 
space called a "buffer'. You replace the buffer’s 
contents each time you delete text. 


| temporary 
| buffer 


VSN 

ON 
ON 

VON 





Deleted text is put in a temporary buffer 


Undo delete or You can recall deleted text through the undo and 

paste text paste commands. Undo (u, U) puts the deleted text 
back in the file as if you never deleted it. You can 
place the deleted text anywhere in the file by moving 
the cursor and using a paste command (p, P). 
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Moving and copying text 


When you move text, you delete (dd) it from its 
current location and then paste (p, P) it somewhere 
else in the file. Copying text (yy) puts a copy of the 
text in the buffer and leaves the original lines in place. 
You can then paste the copy anywhere in the file. 


Moving and Here’s a brief list of moving and copying commands: 


What does it do? 


join lines together 
copy ("yank") a line 
copy n lines (where n is a number) 


copying 
commands 


cut (delete) a line 

cut (delete) n lines (where n is a 
number) 

paste a line below the cursor line 
paste above the cursor line 





Join lines (J) The J command reformats text. As you delete or edit 
text, you may produce a lot of short lines. 


The sky 
is grey 


and cloudy. 
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Using J to make 
lines look better 


Copy line (yy) 


Paste lines (p or 
P) 


Copy several 
lines (nyy) 
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You can join lines with the J command to make them 
a more reasonable length. 


The sky 1s grey and cloudy 





vi expects you to use the J command or a separate 
formatting program (such as nroff) to format lines 
and paragraphs before you print the file. 


To copy a line of text, move the cursor anywhere on 
the line you want to copy and press yy (yank). You 
don’t see anything happen on your screen; however, 
the editor has placed the line in a temporary buffer. 


Use one of the paste commands (p or P) to duplicate 
the line somewhere else. 


Use the nyy command to copy several lines of text. 
For example, to copy 20 lines of text, move the cursor 
to the first line of the block and press 20yy. Then, 
move the cursor to where you want the text, and press 
a paste command (p or P). 
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Cut text (dd or 
ndd) 


Temporary buffer 
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To move text from one place to another, use the dd or 
ndd commands. You learned how to use these 
commands to delete text in the previous section of this 
chapter. You can also use these commands to cut text 
from a file and put it somewhere else. 


When you delete text, the editor removes it from its 
current location and places it into a temporary buffer. 
When you paste text, the editor places the text in the 
buffer back in the file. 


Remember, if you perform another copy or delete 


command, the text in the buffer is replaced by the new 
text; the buffer’s original contents disappears. 


temporary buffer 





delete paste 


Delete or yank puts text in temporary buffer; paste puts text 


back in a file 
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Special buffers Actually, the temporary buffer’s contents are not 
really deleted; they are actually moved to a "history 
buffer". Read an advanced vi manual to learn about 
these and other special buffers. 
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Changing text 


To change text, move the cursor to where you want to 
make your change, press the appropriate command 
(ce, C, ew, r, R), and rekey the text. 


Change Here’s a list of the most frequently used change 
commands commands. 


What does it do? 


change a word 
erase a line and insert 


change to end of line 

replace a single character; remain i 
command mode 
retype to the end of a line; remain in 
insert mode 





Replace a You can change a single letter with the r (replace) 

character command. Simply move the cursor over the letter you 
want to change, press r, then type the correct letter. 
After you replace the character, vi is in command 


mode. 
Change word To change a single word, move the cursor to the 
(cw) beginning of the word you want to change and press 


cw (change word); vi places a $ (dollar sign) at the end 
of the word. Type the correct word or words over the 
wrong word. Press ESC when you complete the 
change. 
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Punctuation is 
considered a 
word 


Change an 
entire line (cc) 


Change to the 
end of a line (C) 


Replace more 
than 1 word (kR) 
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The ew command considers any punctuation mark as 
a separate word. For example, if you want to change 
a word in quotes, move the cursor to the first letter of 
the word, not to the quotation mark. 


vi has several ways to change a line: ec, C, and R. 


If you want to change an entire line, use the ce 
command. cc erases the current line and puts you in 
insert mode so you can rekey it. 


If you only want to change the end of a line, use the C 
(SHIFT-C) command. This command erases text from 
the cursor to the end of the line and puts you in insert 
mode so you can rekey the text. 


Another way to change the text on a line is the R 
(replace) command. R puts you in a replace mode. 
Each character you type replaces the current 
character on the line. When you finish a line, you’re 
still in insert mode. Any new lines you type are 
added. R replaces only the current line; it doesn’t 
continue in replace mode after that line, although 
youre still in insert mode and can keep adding new 
lines. 
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Undoing changes 


This section explains how to undo changes and correct 
editing errors with the undo commands. 


Undocommands : 
(u, U) What does it do? 


undo the last command 
undo all the changes recently made 
to the current line 





Use to fix The undo commands are useful for: 
accidental 


e bringing back text you accidentally delete 
deletes and cuts 


¢ removing text you accidentally insert 


e changing your mind about an edit 


Temporary buffer Remember, deleted text is placed in a temporary 
buffer so when you undo the delete commands, the 
editor pulls the text out of the buffer and puts it back 
into your text file. 


Difference The difference between the u and U commands is the 

between u and U number of changes that are undone. The u command 
undoes only the last command. The U command 
undoes all the commands performed on the current 
line since you moved to it. However, if you move off a 
line, U can no longer undo changes to it. 
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Searching for text 


Search You can look for a word or phrase with search 

commands commands. The search commands look forward (n) or 
backward (N) for one or more characters. Here’s a list 
of the most frequently used search commands. 


/ (slash) search for one or more characters 
n repeat search 
N reverse search 





While in command mode, press /, type the text you're 
looking for (called the "search string" because it’s a 
string of characters), and press RETURN. vi puts the 
cursor on the first match; if necessary, the editor 
scrolls through the file to find the string of characters. 


Search (/) and 


Press n (next forward) or N (next backward) to search 


next (n, N) for the next occurrence of the string. 

Use search with The search command is frequently used in 

change and conjunction with the change and repeat commands. 
repeat You can use search and repeat commands to move 
commands through a file and change all or some occurrences of a 


specific string. 


vi also has many powerful replace functions, some of 
which work in conjunction with the search command. 
Read any advanced vi manual to learn about the 
replace functions. 
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Repeating changes 


Repeat changes 
(.) 


Use with other 
commands 


Repeat delete 


Use with search 
and replace 
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Use the dot (period key) command to repeat the last 
change you made. This is a very useful function when 
you want to repeat a command without pressing the 
command sequence again. 


You can use the dot command to repeat the following 
commands: 


e delete (dw, D, dd, ndd) 
e insert (1, I, a, A, o, O) 
e change (r, ew, ce, C, R) 


* copy and paste (yy or nyy and p or P) 


NOTE: The dot command doesn’t work 
with searches; to repeat a search, 
use norN. 


For example, to delete words on different lines, simply 
press dw for the first delete, then move to the next 
word you want to delete and press the period key. The 
dot command saves you from having to press dw for 
each word you delete. The dot command works the 
same way with any other command. 


Use the dot command with search and replace 
sequences. For example, you can easily change a word 
throughout a file. First, look for the word with the / 
(slash) command, then change it with the cw 
command and press ESC. To continue through the 
file, press n to find the next occurrence and press the 
period key to repeat the change. 
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Troubleshooting 


Problem 


Your command 
doesn’t work and 
appears in your 
text file 


Your text doesn’t 
display on your 
screen 


You can’t save 
your file or exit vi 


The wrong file or 
a blank file 
appears on your 
screen 
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Solution 


You're probably not in command mode. Press ESC, 
then press the command key. 


You're probably not in insert mode. Press ESC and 
one of the text insertion keys (a, A, o, O, 1, I). 


You probably entered vi without a filename. You 
must save your work to a file by using the :w 
command. Type :w filename and press RETURN. 


You probably typed the wrong filename. Quit out of 
the current file with :q! and retype vi filename with 
the correct filename. viis case-sensitive and 
considers a blank between two words as two separate 
file names, so make sure you type the filename 


properly. 
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Using electronic mail 


Ways fo use elm 


elm 
username 


Read message menu 


seas 


G help 

b bounce (forward) 
d delete 

g group reply 

1 return to mailbox 
p print 

Q quit immediately 
r 

S 

u 

E 


select send 
from 
mailbox 
screen 





reply 

save in file 
undelete 

read next message 


enter 


USeErname 





SPAC 





Mailbox screen options 





enter 
subject 











Cc 
oe. 
7 help rr 
site as c change folders i) 
message message d delete ® 
with editor with editor m mail a new message rf 
O options =. 
p print 3 
select send select send ; Q 
option option q quit = 
r reply 
S save in file 
u undelete 
elm sends elm sends ; ; 
mai mai x quick quit 








Using electronic mail 


Why read this 
chapter? 


Why use 
electronic mail? 


Comparing talk 
to electronic 
mail 


Using electronic mail 


This chapter gives you a brief introduction to 
electronic mail. You'll learn how to use elm and mail 
to send, read, delete, and store messages. 


Electronic mail is a quick and easy way to 
communicate with other users. You can use 
electronic mail to send messages or files to co- 
workers. You can use it to ask questions and send 
replies. It works even if other users aren’t logged in. 
Mail messages wait in their mailboxes until they’re 
ready to read them. 


Electronic mail is more than a method of sending 
messages; it’s also a means of managing mailed files. 
You can create and send a memo to a group of people, 
then print it, delete it, or store it in a folder so you can 
refer to the information later. You can also use mail 
to send notes to yourself. 


Unlike the talk program, recipients of mail don’t have 
to be active users at the time someone sends them a 
message. You can send mail messages to users at any 
time and your mail will wait for the recipients. As 
soon as they log in to the system, they'll see a message 
that says "you have mail." Then they can use one of 
the electronic mail programs to read and respond to 
the message. 
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Types of 
electronic mail 


What is elm? 


What is mail? 
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/ | 





You can talk only to active users, buf you can send mail to 


active and inactive users 


You can use several different types of electronic mail 
with UNIX. Two of the most common programs are 
mail and elm. 


The elm program is menu driven and provides help 
messages and prompts on-screen as you work. You 
can set elm menus to match your level of expertise 
through the elm options. This chapter briefly 
describes the options available for beginners. 


You can also use mail, the traditional UNIX mailer, to 
send and read messages; however, the mail program 
doesn’t include a menu and doesn't have all the extra 
features that elm has. It is most useful for sending 
quick, short notes. 
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Starting elm for the first time 


Create elm The first time you try to use elm, the program 
directory and displays several prompts that help you automatically 
mail folder set up elm directories on your system. 


To begin the initialization, type elm at your shell 
prompt. Two notices appear asking if you want elm 
to set up an elm directory and a mail folder for you. 
Answer yes (press y) to both these queries. elm then 
creates the Mail directory and displays the mailbox 
screen. 
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sending mail through elm 


There are three ways to send mail through elm: 


Mailbox screen e type elm at a shell prompt to start the elm 
mailbox screen 


Shortcut °¢ type elm username to skip over the elm 
mailbox screen and go directly to the subject of 
your message 


Mail files ¢ type elm -s subject username < filename to 
mail a file to another user 
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3 ways to send 
mail 


Using electronic mail 


elm 
with mailbox 
and options menu 


select mail 


option from 
mailbox 
screen 


enter 
username 


enter 
subject 


write 
message 
with editor 


select send 
option 


elm sends 
mail 





elm 
shortcut 


elm 
username 


enter 
subject 


write 
message 
with editor 


select send 
option 


elm senas 
mail 





Three ways to send mail 


elm 
send file 


command 


elm -s 
subject 
username 
< filename 


elm sends 
mail 
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Send command 


Enter subject and 
copy fo list 


Use a text editor 
to write the 
message 
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The simplest way to send a message is by typing elm 
username at the shell prompt. 





elm displays the full name of the user and prompts 
you for the subject and the usernames of people who 
should receive copies of the message. 





elm starts the text editor (vi is the default editor) so 
you can type the message. When you have saved your 
message and quit from the editor, elm asks you to 
send, cancel (forget), or edit the message, or change 
the headers. 


Please choose one of the following options by 
parenthesized letter: s 


Ge)ditl message, edit h)eaders, sjend 12, or 
fyorget it : : 
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Send message 


Forget message 


Change 
message 


Change header 
information 
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To send the message, simply press RETURN; send (s) 
is the default value. 


To forget (cancel) a message, type f. The message is 
stored in a file (cancelled.mail) in your home 
directory. 


If you want to change or expand your message, you 
can edit it by pressing e. vi displays your message file 
so you can edit it. After you save your corrected 
message, you can send it. 


If you want to change or add information to your 
headers, press h. You can change the subject, the 
recipient, and other types of address information. 


Expires : 
Priority. 
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Reading mail through elm 


Access elm Type elm; the first screen you see is your mailbox, 
mailbox screen which includes an index of mail messages and a menu 
of options. 
mailbox line 
list of 
message status messages selection 
bar 


MaAlbox is Yyi/simpson’ with messages 


Smith ( test 
Jones lunch 
projplans 


You can use any of the following commands ma 
pressing the first character: 


djelete or u)ndelete mail,,m)ailva me. 
r)eply or fjorward: mail; q) uit. 

To read a meSsage, mae SS. <return> 

Aer amoug, ap, oe ete see 


Command 3 





description of 
So commands 


Sample of the elm mailbox screen 
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Message lines The selected message line is highlighted; whatever 
command you choose affects the highlighted message. 
You can select any of the messages on the screen by 
pressing j to move down the list of messages or 
pressing k to move up. Press SPACEBAR to read a 


message. 


Mailbox is '’/var/mail/simpson’ with 3 messages 


May 23:2 Be Smith (23) Lest 
2. May 23 8 Jones (16) tunch 
. Jones (22) 


testplans 
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read 
messages 


SPACEBAR 


delete reply to 
message message 


d r 





Using the elm mailbox screen 


129 


Parts of a A message has three parts: a header, a body, and a 
message signature. 


From: Joe Simpson 

Subject: Lunch on Friday header 
To: Documentation Staff 

Date: Mon, 7 May.90 03:30. EDT 


InLS- LS Just a reminder about 
| lunch on Friday I made reservations 
at Joe's Cafe for noon 


PIfll: see-you «there! 


Joe Simpson abcdoc! joe 





Sample message 


If the message contains more lines than can fit ona 
screen, press SPACEBAR to scroll to the next page of 
the message. 


If you have more than one message to view, press the 
SPACEBAR to display the next message. 
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Affer you read a 
message... 


Using electronic mail 


After you read a message, enter an option at the 


command prompt. Here’s a partial list of options; 
notice that some don’t appear in the menu at the 
bottom of the screen, but are listed in the on-line help 


screen. 


COpy 


delete 
help 


group reply 


print 
bounce 


reply 
save 


undelete 
index 


quit 


copy the message to a 
designated folder 

delete message 

access information about 
commands 

reply to everyone who 
received the message 
print the message 
bounce (remail) the 
message to another user 
reply to the message 
save the message in a 
folder 

undo the delete request 
for a message 

return to the mailbox 
screen 

quit elm 
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Deleting messages 


Mark message 
for deletion 


Quit 


Confirm the 
deletion 
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You can mark a message for deletion from the mailbox 
screen or the message screen by pressing d. The 
messages appear on the mailbox screen with "D" as 
the status. This means that you've selected the 
messages to be deleted; however, elm hasn’t deleted 
them yet. Messages aren’t deleted until you quit out 
of elm and confirm that the messages should be 
deleted. 


marked for deletion 


1 May 23 E. Smith (23) test: 
2 May 23 B. Jones (16) Lone hi 





When you press q (to quit), elm displays a 
confirmation message. 


Command: Quit Delete messages? (y/n) n 





Press y to delete the messages. 


However, if you’ve changed your mind about deleting 
the messages, press RETURN for no (N is the default). 
The elm program won't delete the messages. 
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mark for deletion 


quit (q) 


confirm deletion 
(y orn) 
Steps for deleting 


a message 





deleted not deleted 


Several steps to delete a message 
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saving and sforing mail 


Saving and If you choose to save your mail messages, you can 
storing mail store them in a mail folder or leave them in your 
mailbox. 


incoming mail in mailbox 
(/var/mail/joe) 





leave mail 


IN mailoox 






Ex 
mary 


save mail in folders 
by sender name 
(/nome/joe/Mail/carol) 


Saving mail messages 


Save mail in To save mail in a sender folder (/home/username/Mail/ 
sender folder sender), press s at the command prompt on the 
mailbox screen. 


Quit elm When you use the q option to quit, elm displays a 
second confirmation prompt. If you answer yes, all 
the mail you’ve read is moved to a received mail folder 
(/nome/username/Mail/received), where you can find it 
later. The default is no (which keeps the messages in 
your mailbox until you delete them). 
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Customizing your signature 


Edit signature 
files 


Local and 
remote 
signatures 
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In the Reading a message section of this chapter, you 
saw how each message begins with a header and ends 
with a signature line. This section explains how you 
can create your own signature line. 


To design special signatures, create two .signature 
files in your home directory. Then add the filenames 
to the localsignature and remotesignature fields in 
the .elm/elmrc file. 


If you don’t have an .elm/elmrc file, press o (for the 
options command) on the elm mailbox screen. Once 
you've accessed the options submenu, elm 
automatically creates an elmrc file for you in the .elm 
directory. 


Let’ s have a planning meeting Message - 
on Friday morning. ae 





Joe Simpson ABC Corporation X3654_ | signature 


If you like, you can use the same .signature file for 
both remote and local signatures. However, a local 
signature usually includes your username (joe), and a 
remote signature includes additional information that 
people outside your company need in order to contact 
you (full phone number, system name, e-mail 
address). 
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Customizing elm 


2 ways to You can customize the elm program in two ways: 

customize elm through the elm options screen and by editing the 
.elm/elmrc file. 

Options screen To access the elm options screen, type o at the 


command prompt on the mailbox screen. Here are 
brief descriptions of some options you can change. 


arrow arrows or a reverse video bara 
selection indicator 

calendar file where calendar entries are 
saved 

display program used to display 
messages 

editor text editor 

folder folder directory 

menu display commands on mailbox 
screen 

outbound file where copies of messages 
you send are automatically 
saved 

print printer where messages are 
printed 

sort order in which to display mail 
messages 

user level level of elm to use for menus 
and commands 

your name the full name, comment, or 
group you want to display on 
messages 





To find out more about these options, press ? at the 
command prompt on the option screen. 
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Configuration file 
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Regardless of how you change options, elm 


automatically creates a configuration file named 
.elm/elmrc. 


The file contains some of the same options as the 
options screen plus many others; it also provides 
simple instructions to help you edit the file. Here’s a 
sample of an .elm/elmrc file. 


#  .elm/elmrce - options file for the mail system 


# For yes/no settings with ?, ON means yes, OFF 
# means no 


# where to save calendar entries 
calendar = /home/joe/calendar 


# what editor to use 
editor = vi 


# should the default be to delete 
# messages we’ve marked for 

# deletion? 

escape = ~ 


# the full user name for outbound mail 
fullname = Joe Smith 


# where to save my mail to, default directory 1s. 
Maas ; 





Sample .elm/elmrc file 
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Using mail 


Differences 
between elm 
and mail 


Send a message 


Read a message 
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mail is another electronic mail program. You can 
perform many of the same tasks with mail as you can 
with elm; however, you cannot correct errors as easily 
with mail. You can’t select menu options (although 
you can access a list of commands through help), and 
you can’t select specific messages to read. 


To send a message, type mail username. When the 
shell prompt disappears, type your message. End the 
message with a period (.) on a blank line; this tells 
mail to send the message. 





To read your messages, simply type mail. The mail 
program presents all your messages, beginning with 
the last one received. Press RETURN to view each 
message. 
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After reading a After reading each message, tell the mail program 

message... what to do with it. For a full list of mail options, press 
? at the prompt. Here are some of the options you can 
use. 


delete 

print 

quit mail 

reply to message 


save message in mailbox format 

undelete message number n 

write as text file 

quit mail without updating messages 
RETURN read next message 
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Troubleshooting 


Problem 


Can’t start elm 


Your elm 
commands don’t 
work 


You receive mail 
intended for 
another user 


Your send or 
copy list is 
incorrect or 
incomplete 
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Solution 


You probably don’t have .elm or Mail directories in 
your home directory. When you first try to use elm, 
queries ask if you want elm to create these 
directories. Make sure you answer yes. 


You probably didn’t type the command correctly. 
Check the screen prompts for messages and valid 
options. 


Make sure you include a valid username in the 
command line if you are using the elm shortcut. 


If you are sending a file through elm, make sure you 
include a < (less than sign) and a valid username and 
filename. 


Use either the f (forward) or b (bounce) command to 
send the message to the appropriate user. 


If you haven’t sent the message yet, you can use the h 
(edit header) command from the send message screen 
to make the necessary changes. 
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Problem 


You decide not 
to senda 
message 


You accidentally 
mark a message 
for deletion 
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Solution 


If you have not sent the message yet, you can use the 
f (forget) command from the send message screen to 
cancel the message. 


If you’ve marked a message for deletion but have not 
yet exited from elm, you can undelete the message 
with the u command or answer no to the "Delete 
messages?" query that appears when you quit elm. 
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Networking 


Networking terms and concepts 





Local world The machine you are logged in to and using 


Global world All systems and processes on your network 


Remote login Log in to a different computer over the network by 
typing your login name and password, then use that 
system’s resources; your local world is now the othe 





system 
Local tasks Global tasks 
who List users who are mesg mesg y orn to receive or 
logged in to the system reject incoming talk 
finger Similartowhobutmore| talk Establish a dialogue wit 
detailed another user at any 
ps Processes running on system on the network 
local machine mail Sendamessage to anothe 
wall Senda message to user’s mailbox, where it 
everyone logged in to waits until it is read 
the machine ping Check if a system is on 
kill Stop a running process and connected to the 
date Display the system’s network 
date and time rlogin Log in to a different 
Is,cp___ List or use local files system 


rep Copy files over the 
network to and from 
other systems 





BuDHOMION 











Networking 


What is a 
network? 


What do you 
need to make a 
network? 


Networking 


A network (in its most basic form) consists of 
computers connected together by a cable. Depending 
on the type of network, users of these computers can 
talk to each other, share files, exchange mail, and 
share peripherals. 


One unique feature of UNIX is its built-in networking 
capabilities. With most operating systems, you have 
to buy special applications to share files and send 
mail. UNIX has its own mail system, its own system 
for sharing files over the network, and its own set of 
networking utilities. In most cases, UNIX has several 
different types of networking software, so you can 
connect to almost any kind of network. 


Networks usually require some special hardware, 
such as an expansion card and a cable. Once you add 
these parts to your computer, you have everything 
you need to communicate over a network. 
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Local vs. global 
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There are two types of network activity: local and 
global. 


Your local world is any system you happen to be 
logged into and any users logged into that same 
system. Your global world is every system connected 
to the network. 





Local activity is relative to you, and takes place on the 
same system you're logged in to; global activity takes 
place all over the network around you. You can 
generally monitor local activity, since it takes place on 
the system you are using; it is very difficult to monitor 
or even guess at all the global activity that might be 
taking place on other network systems. 


This chapter shows you how to perform local tasks 
and interact with a global community. 
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Working locally vs. working globally 


What is a local 
environment? 
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Your local environment is any system that you are 
currently logged in to. This could be the system on 
your desktop, the mainframe computer in another 
building, or a different workstation to which you have 
transferred’ your session activity. 





rlogin 


rlogin transfers you to a different system 


How can you consider another system local? The 
answer is fairly straightforward. You can work on 
files, look at directories, work in your home directory, 
and so on when you log into your personal system. 
You can also log into someone else’s system (if you 
have permission) and do these exact same things. The 
only difference is which system is processing all the 
work. When you are logged in to your personal 
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Local is arelative 
term 
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system, it’s doing the work. When you log in to 
another system, that system is doing all the work and 
defines your local environment. 


Your local environment is relative to where you are. 
Evverbody has their own local world, which may or 
may not be the same as yours. You all share the same 
global world, but from your own local position. UNIX 
provides you with certain commands for getting 
information about your local environment. 


Many different kinds of systems can be part of your 
global network; each system is still its own separate 
local world. 





Global environment includes different types of systems 
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Local tasks Local tasks include: 


Global tasks 


listing processes 

listing current users 

working with files and directories 
broadcasting a message 


system maintenance 


Global tasks are specific tasks you can perform that 


affect other users and systems on the network, either 
in the same building or perhaps many miles away. 
Some examples of global tasks are: 
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having a conversation with another user over 
the network 


sending mail to users on other systems 
copying files to or from other systems 


changing your local environment to another 
system by remotely logging in over a network 


checking the status of another system 


network maintenance 
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Types of global network activity 


Unlike your local environment, it doesn’t matter 
where your global environment originates. You can 
perform global tasks, like talking over the network, no 
matter where you are logged in. The key toa 
distributed network is that some activity occurs 
everywhere, and no one system does all the work for 
everyone. 
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Looking at your local world 


Check to see The who command lists all users currently logged 

who’s logged in into your system. The list you get depends on your 
local environment. If you are logged into your 
personal system, who shows you everyone else logged 
into your personal system. 


If you are logged into another system, who lists the 
other users logged into that system. 


Using the who command is simple. 





The who command tells you that two users are logged 
in (joe and pat), what terminal they are logged in to, 
and the time they logged in. 
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Another method 
for seeing who’s 
logged in 
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You can also use a command called finger to see who 
is logged into your local environment. finger is 
similar to who, except it gives you some more 
information about each user. 


S finger 


fogin Newme 839 TY = dlc = hen = Where 





In addition to login name, terminal, and login date, 
finger gives you the user’s full name, how long he has 
been idle, and what he is doing. 


A process starts when you type a command. The who 
command starts a process that looks for people logged 
into the system, then displays information about 
them. Is starts a process that displays the files in a 
directory. Applications such as word processors are 
also considered processes; the process is the entire 
program. Every UNIX command you type starts a 
process. 
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Check on You can check to see what processes are running on 
running your local system by using the ps command with the - 
processes e option (for everyone). 


Information |What does it mean? 


ID number for this process 
Terminal on which the process is 
running 

Time the process has been running 
Name of the process 





ps has many more options. You can type ps -a and see 
only the most important user processes or you can 
type ps -ef and see all processes displayed in long 
format. See the man page for a complete list of ps 
options. 
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Broadcast a 
message fo 
everyone on 
your system 
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ps -a 
most 
frequently 
used processes 










ps -e 


process 
information 
for every user 










process 
information 
for you 


The progression of information requests 


Amiga UNIX lets you send a message to everyone who 
is logged into your computer. This is especially useful 
if you plan to shut your computer down and want to 
warn people using your system. The command is 
called wall (write to all users) and broadcasts a 
message to everyone logged into your system. Some 
users might have messages turned off, so you can’t 
talk to them or send a message to them. Login as root 
before using the wall command to be sure that 
everyone gets your message. 


S wall 
System 1S going down soon 





Type the message, then press CTRL-D to signal the 
end of the broadcast. Your message goes out to all 
users logged in to your system. 
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Working in a global world 


Do you want You can talk with other users over the network by 
other users to establishing a two-way exchange of messages. Either 
talk with you? you or the other person starts the dialogue by sending 


a message out and waiting for a response. 


You can turn your messages off so other users can’t 
talk to you or interrupt you. This has the same effect 
as taking your phone off the hook. To turn your 
messages off, type mesg n. 


Check that your messages are off by typing mesg 
alone. 


To turn your messages back on, type mesg y. 
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Talk with another The talk command lets you establish a dialogue with 

user over the another user on the network (or on your personal 

network system). After you establish the dialogue, you can 
communicate back and forth by typing at your 
computer. 


Talk to users who are logged in and answering 


Start talk by typing talk username. If the user is on 
another system, you must append the systemname to 
the username. 


S talk username@systemname 
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Username is the user’s login name and systemname is 
the name of the user’s system. After you type this 
command, the screen clears and the talk screen 
appears. 


[Waitang for your party to fespond) = = = 




















Type on the top; read the bottom 


The talk screen is divided into two parts. The top half 
is where you type and the bottom half is where you see 
what the other person types. Note the first message 
at the top of your screen. You can’t start 
communicating until the other person responds to 
you. 


Once you establish communication with the other 
user, you can type messages back and forth. When 
you want to end the talk session, press CTRL-C. 
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Send mail 


156 


Mail lets you send messages without disturbing the 
recipient. In fact, the person to whom you send mail 
doesn’t even have to be logged into the system. You 
can send mail to someone on your system or another 
system. 


/ 





send mail regardless of whether user is logged in and 
answering 


talk is an active communication system, while mail is 
a totally passive communication system. When you 
send mail to someone, it goes into that person’s 
mailbox. The next time that person logs in, his shell 
tells him that mail is waiting. If he never reads his 
mail, he will never see your message. 
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Check to see if 
other systems 
are active 


Use finger to 
check onremote 
users 
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Amiga UNIX includes a public domain mail program 
called elm. See Using electronic mail in this book for 
information about sending and reading mail. You can 
also use the standard mail program, described briefly 
in the same chapter. 


Before you log into a remote system, you might want 
to check and see whether it is active. You use the 
ping command to do this. ping works by sending a 
request over the network and telling you if the remote 
system answers. To use ping, you need the name of 
the other system. 





You can also check to see what users are doing on a 
remote system before you log in to it. Use the finger 
command to get information about users on a remote 
system. 


© finger @systemname A 
NAME GROUP FULLNAME WHAT IDLE TTY LOCATION 


joe other Joe Jones ksh 301  pts/5amigal 
sue other sue Jones csh 4 02 pts/6 amiga2 
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Access a remote To use a UNIX operating system, you must first log in 

computer to it. This goes for your personal system and any 
other system over the network to which you have 
access. Even though you’re logged into your own 
system, you still have to identify yourself and be 
accepted by any other system you want to use. 








































































































passwd file lists users; hosts file lists systems 


Use the remote You don’t always have to type your username and 

login command password to log in to a remote system. You could use 
a command called rlogin (remote login) to automate 
the login procedure. 
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How does rlogin 
work? 


Create a .rhosts 
file 
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You must have a user account on the other system. 
Both systems also need a hosts file in their /etc 
directories that list your system name and number. 
Once the other system knows who you are (through 
/etc/passwd and /etc/hosts) you can type rlogin 
systemname to login into the remote system. The 
remote system still asks for your password, but it 
knows your username. 


To further automate the rlogin procedure, create a 
rhosts file in your home directory on the remote 
system. 


Use an editor (such as vi) to create the file. Put your 
rhosts file in your home directory on any system you 
login to or want to exchange files with. If you want 
people from that system to access your system, put 
their .rhosts on your system. The .rhosts on the 
destination system should identify the system from 
which you type the rlogin command. 





.thosts on a remote system 
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The .rhosts lets you login by typing the system name. 


So wlogin systemname 





Normal 
login ———? name? ——> password? ——> shell 


rlogin 
without ———--———————> password? ——> _ shell 
hosts 


rlogin 
with .rhosts 
on > shell 


destination system 


login shortcut through rlogin 
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Copy files over The third chapter of this book discusses copying files 

the network locally using ep. You can do the same thing globally 
using rep. rep stands for remote copy and works 
much the same way as cp. 





You can copy files to other systems 


To copy files over the network, type rep 
systemname:filename filename. The examples on 
the following page illustrate some uses for the rep 
command. 
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copy from the _ the file called put it in my 

remote mydoc home directory 

system on this system 
and call if doc2 


ss rep remotecomp /home/joe/mydoc doc2 





Copy files to You can also rep files from your system to another 
another system system. 


copy this put it on this in this directory 


file from remote system and call 
my system it doc2 


S$ rep mydoc remotecomp Jnome/joe/dece 
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rcp needs a In order to rep files, you must have a .rhosts file in 
.thosts your home directory on the remote system. 


system a system b 


$ rcp file newfile 





Put .rhosts on the other system to recognize you 
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seiting up a network 


Join a network vs 
creating one 


What makes up a 
network? 


The physical 
connection 
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You may already have a network to which you want to 
connect your Amiga. If this is the case, you need to 
get some information from the network 
administrator. Your computer’s name and address 
must not conflict with any other systems on the 
network. 


You can create a network if you do not already have 
one. The steps for creating a network are basically 
the same as connecting to an existing one, except that 
you are the network administrator and you decide 
what addresses to use. 


These are the things you need to join or create a 
network: 

¢ a physical connection to the network 

¢ aunique system name 

¢ aunique system number (address) 


¢ a hosts file (your "directory’ to the other 
computers on the network) 


* auser account on any remote system(s) you 
want to use 


e a.rhosts file on remote systems to allow remote 
file copies and to simplify remote logins 


These requirements are described in the next few 
pages. 


The physical connection to your network depends on 
the type of network you are using. For an Ethernet or 
TCP/IP network, you have to install an expansion 
card inside your system, run a special cable to this 
card, and connect it to the network. 


Networking 


The system 
address and 
hosts file 


Networking 


You could also have a serial network where you 
connect a special cable to the Amiga’s built in serial 
port. Using the built-in serial port to connect 
computers is probably the easiest and least expensive 
way of networking. Serial networks have fewer 
features than other types of networks, which limits 
their usefulness to being just another login screen. 





















































Dumb terminals connected 
to your system (serial) 






















































































































































































Systems networked together 


Different ways of working with other users 


Each system on a network must have a unique system 
number and name. Think of a telephone directory. 
When someone wants to call you they find your name 
in the phone book, read your phone number, then dial 
it. Your hosts file (located in /etc/hosts) serves this 
same purpose. You can’t contact a computer that is 
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See your system 
administrator for 
a valid address 
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not listed in your hosts file. Also, other people can’t 
contact you if your address isn’t listed in their hosts 
file. 


If you are connecting to an existing network, be sure 
to ask your system administrator for your number. 
Don’t just make one up. You should also check to see 
that no one else is using your system name. Your 
system administrator should give you a valid address 
and put your name and address in the other network 
hosts file. He or she should also give you a copy of the 
hosts file. If you are creating your own network, see 
Editing system files later in this book for more 
information about the hosts file. 


You can talk to a remote computer, as long as you both 
have a hosts file. This hosts file must contain both 
your system information and the remote system’s 
information. 


In order to log into a remote system, you must have a 
user account on that system. You may be connected 
to hundreds of systems, based on your hosts file and 
your network wiring, but each system’s owner decides 
whether to let you log into that system. 


You can let other people log in to your computer by 
setting up user accounts for them. For information on 
setting up a user account, see the chapter called 
Maintaining your system. 
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Administering a network 


Advanced 
networking 
topics 


Network 
administation 
tasks 
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Networking is much more complicated than we can 
cover in this chapter. You should, however, now have 
a simple picture of how to work over a network, both 
locally and globally. There are many other 
networking tasks that you could spend months 
learning, and numerous commands that you can 
perform remotely. 


If your computer is connected to a large network, you 
might need to perform periodic network 
administration tasks. These tasks include: 


setting up hardware for new users 
expanding the size of your network 


adding user accounts to your and all other 
systems 


adding new systems to your hosts file 


making specific files and directories available to 
other users 


mounting file systems from other systems 


sharing printers 


The best way to learn more is to read an advanced 
networking guide and experiment with your network. 


167 


Getting more 
information 


Basic skills are 
enough 
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Networking with UNIX is fairly generic, which is why 
you can connect so many different systems together. 
Many of the world’s most popular networking 
schemes are included in Release 4 UNIX and other 
UNIX enhancements. Because UNIX networking is so 
generic, there are many good books on the subject. If 
you want to dive deeper into the world of networking, 
check your local bookstore for UNIX networking books. 


After reading this chapter, you should be fully 
equipped to communicate with other users and 
systems. The list of topics above are useful, and at 
times important, but they are not critical to basic 
networking. 
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Troubleshooting 


Problem 


Can’t rlogin to a 
remote system 


Can’t talk to 
another user 


Can't broadcast 
a message to 
other users 
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Solution 


You're not in the .rhosts (or you don’t have a .rhosts) 
file in your home directory on the remote system. 


Check the physical connections. 
You don’t have a user account on the remote system. 
You typed your login name or password incorrectly. 


Your /etc/hosts file doesn’t contain the name of the 
system you are trying to login to. 


Use the ping command to see if the other system is 
‘alive’. It might be turned off or disconnected from 
the network. 


The other user has his or her messages turned off 
(mesg n). 


The other user is not logged in. 


The other user doesn’t want to respond. 


The other users have their messages turned off (mesg 
n). 


You are not logged in as root. 
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Problem 


mail won’t work 


Can't copy a file 
to or from 
another system 
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Solution 


Make sure you specified the right system and user 
name. 


Read your mail; mail sends you a message explaining 
why it can’t deliver your message. 


You don’t have a user account on the remote system. 


You don’t have .rhosts in your home directory on the 
remote system. 


Your .rhosts file on the remote system doesn’t 
recognize you or your current system. 
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Special features of Amiga UNIX 


Amiga UNIX commands Amiga UNIX directories 





se 






color set or show screen | Special Amiga UNIX programs an 
color _ utilities are stored in the followin 
fdfmt format a floppy disk _ directories. 
getscr define and create a 
virtual screen /usr/amiga/bin 
passwdall set/erase all system /usr/amiga/etc 
account passwords /usy/amiga/lib/kmap 
rdb set/show hard disk /usr/amiga/lib/font 
partitions /asr/public/bin 
S10C set/display keymap, 


font, and screen size 


Public domain programs 





Amiga UNIX includes several public domain alternatives to 
standard System V Release 4 programs. The System V Release 4 
programs still exist and work properly. 


Unix standard Amiga UNIX alternate 
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special features of Amiga UNIX 


Why should you Your Amiga UNIX system is a complete version of 
read this AT&T’s UNIX System V Release 4.0 (Release 4) and 
chapter? provides all the features of that operating system. 


However, Amiga UNIX is more than just Release 4; it 
combines elements from several sources: 


¢ Amiga high resolution graphics 


e Amiga enhancements, including virtual screens, 
device drivers, and system-specific hardware 
functions 


¢ AT&T UNIX, which includes Berkeley and Xenix 
commands 


¢ public domain utilities 


Read this chapter to learn how Amiga UNIX differs 
from other versions of Release 4 UNIX. You can also 
read man pages for any of the special Amiga UNIX 
programs. The regular man command works for most 
Amiga enhancements. 


Where are the Amiga UNIX programs and utilities that are not 
Amiga UNIX available on any other system are in the following 
programs? directories: 


e /usr/amiga/bin 

e /usr/amiga/etc 

e /usr/amiga/lib/kmap 
¢ /usr/amiga/lib/font 

¢ /usr/public/bin 
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What features are unique to Amiga UNIX? 


Amiga UNIX enhancements cover four distinct areas: 


e screen management 


¢ online guided interface to user and 
administrator tasks 


e public domain utility programs 


¢ miscellaneous utilities and system calls unique 
to the Amiga port of the UNIX operating system 


screens and Screen management programs define and create 

display options virtual screens, allow access to the Amiga console and 
custom RAM, and control various display elements of 
Amiga screens, including color, font type, and 
character size. 


Public domain We added several public domain programs, and even 

programs documented them as primary options, because they 
are well known and, in some cases, more useful than 
the comparable Release 4 programs. The Release 4 
programs still exist, work properly, and are located in 
the right place; we have simply added alternatives, as 
shown in the following table. 


UNIX standard Amiga UNIX alternate 
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Other public domain programs provide functions not 
included in standard UNIX Release 4. These programs 
are in the directory /usr/public/bin. 


Unique Amiga Some Amiga UNIX features are unique only because of 

UNIX functions the Amiga hardware. Functions such as formatting 
floppy disks and hard disk partitions, connecting a 
parallel printer, and setting a keyboard translation 
map exist in some form on many systems; the specific 
variants for Amiga UNIX are documented in this 
chapter. Again, any unique features are in addition to 
UNIX Release 4; no AT&T, Berkeley, or XENIX 
functions have been removed or replaced. 


Minor changes Some programs were modified as part of the porting 

have no effect process. These minor modifications are transparent 
to users, programmers, and administrators. Most 
importantly, they do not interfere with the pure 
binary compatibility that defines a successful Release 
4 product. These modifications are intrinsic to the 
porting process and have no effect other than to make 
UNIX work properly on an Amiga. 
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What are the 
screen 
functions? 


Are screen 
commands 
necessary? 
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Screen functions are stored in the /usr/amiga/bin, 
/usr/amiga/lib/kmap, and /usr/amiga/lib/fonts 
directories. Screen functions cover the following 
areas: 


e defining virtual screens 

¢ using virtual screens 

e listing virtual screens 

¢ changing the background and foreground colors 
e setting the font size and type 


¢ mapping one of a variety of international 
keyboards to the current character set 

e displaying high resolution graphics on an Amiga 
or Moniterm monitor 


Note that the X Window System and Release 4 
graphic functions are supported by Amiga UNIX 
without modification. Amiga UNIX provides virtual 
screens and customized displays as additions to 
standard UNIX; you don’t need to use these 
enhancements, or any special Amiga UNIX features, to 
operate X or UNIX. Default display options for all 
screens are already defined; you can use Amiga UNIX, 
its virtual screens, and its graphic capabilities 
without ever learning any of the special Amiga 
commands. 
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Virtual screens 


Check the size of 
your screen 


Amiga A2024 
and Moniterm 
monitors 


Define high 
resolution for 
your system 


Based on the resolution of your screen (either what 
you specified in /etc/inittab or what your monitor 
allows) and your font size, Amiga UNIX calculates the 
number of fixed space columns and rows that can fit 
on the screen. Use sioc winsize to see how many 
lines and columns are on your screen. 


S sloc winsize 
LINES=25 COLUMNS=80 


PLINES=200 PCOLUMNS=640 





You can use a special Amiga high resolution display 
setting if you have a Commodore A2024 monitor or a 
Moniterm monitor. These monitors have a graphics 
board that enhances the Amiga’s graphic output for 
higher resolution. 


During installation, you tell your system if you have 
one of these monitor types. You can subsequently 
change this setting with an sioc command that turns 
high resolution on or off. sioc setdisplaytype +4 
turns the high resolution on for the current session; 
sioc setdisplaytype -4 turns it off. These commands 
are not permanent; the system returns to its installed 
state when you reboot. You can change the installed 
state by linking the file /usr/amiga/bin/A2024 to 
either /bin/true (if you have an A2024 or Moniterm) or 
/bin/false. 
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Create a high 
resolution virtual 
screen 


Create a high 
resolution X 
screen 


Set overscan 
parameters 
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S$ In /bin/true /usr/amiga/bin/A2024 





You set the high resolution mode for a particular 
screen in /etc/inittab by using the highest x and y 
settings (x=1024, y=800 or 1024). As with any inittab 
line, it will not be activated until you type init q to 
force a read of the inittab, and log out and log back in 
on that function key. 


You can also create a high resolution X Window 
System screen by using the Xamix or olinit 
commands. These commands test 
/usr/amiga/bin/A2024 to determine if high resolution 
is allowed; if it is, they create the X screen at this 
resolution. 


Even without this high resolution mode, you can 
increase the size of your screen by using overscan. 
Many monitors do not support overscan, which 
involves writing up to 64 extra pixels to both sides and 
the top and bottom of the screen. If your monitor has 
overscan, and you want these extra pixels, modify the 
file /etc/rc2.d/S70sioc. Near the end of this short 
startup file is a commented out line that sets the 
overscan for each of the four screen edges. 
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Mapping the keyboard fo a character set 


Your system uses Your system is installed with a keyboard map that 

a keyboard map tells Amiga UNIX what character to use when a 
specific key is pressed. You can set both a system 
default and a specific override for your current 
session. 


The standard keyboard maps provided with Amiga 
UNIX are listed below. 


cdn French Canadian 
chl, ch2 Swiss 
d German 
Danish 
Spanish 
French 
British 
Italian 
Icelandic 
Norwegian 
Swedish/Finnish 


usaO, usal United States options 
usa2 United States Dvorak keyboard 
usa United States (default keyboard) 
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Set the keyboard 
map 
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Use sioc to change either the current keyboard map 
or the default map. sioc setkmap filename changes 
the current map; sioc setkmap resets the default 
map; and sioc setdefkmap filename changes the 
system default keymap. 


S$ sioc setdefkmap /usr/amiga/lib/kmap/usal 
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Amiga UNIX utilities 


What are the The directories /usr/amiga/bin and /usr/amiga/etc 
Amiga-specific contain programs that are unique to Amiga UNIX, 
programs? most of which are designed specifically for Amiga 


hardware. The most important programs in these 
directories are listed below. 


What does it do? 


A2024 linked to true or false to allow or 
disable high resolution 


color sets or shows the screen color 
fdfmt formats a floppy disk 
getscr defines and creates a virtual screen 


passwdall sets or erases password for all system | _ 
accounts _ 


rdb sets and shows partitions on a hard 
disk 


S10C sets and displays current and default 
key map, font, and screen size 





A2024 and sioc are described earlier in this chapter. 
color and getscer are described in the Getting started 
chapter. rdb is described in the Maintaining your 
system chapter. 


System passwdall is run automatically, as part of the 

passwords installation procedure, to assign a password to the 
system accounts or to remove an existing password 
from those accounts (passwdall -d). 
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Format a floppy fdfmt is a single-line shell script that executes a dd 

disk command with all the options to format a floppy disk; 
the syntax to format a floppy disk in the first floppy 
drive is fdfmt > /dev/rdsk/fdOf. 
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Editing system files 





About system files 





Some system files are customizable files that Amiga UNIX needs to 
function. Use them to customize your environment, add users to 
your system, and name your system. 


Only root can edit system files. 


System files are usually maintained by system administrators. 


Edit system files with an editor such as vi. 


Contents of the system files 





/etc/passwd 
/etc/group 


/etc/profile 


/etc/inittab 
/etce/vfstab 


/etc/hosts 


/etc/nodename 


Identifies users who are allowed to log in to the 
system. 


Identifies users who are logically grouped together 
and who share the same access privileges. 


Contains information that the user’s shell reads 
each time a user logs in. Sets up that user’s 
environment for the login session. 


Contains settings for init levels, virtual screens, 
and serial devices. 


Contains mount information about hard disks and 
file systems. 


Contains information about other computers on 
your network. "Telephone directory’ to the 
network. 


Contains your system name. 
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Editing system files 


What are system 
files? 


How do you edit 
a system file? 


Editing system files 


UNIX system files are special files that only root can 
modify. The system files affect the way UNIX behaves. 
You use them to customize your environment, add 
users and systems to your system, and name your 
system. If you are a user, and not a system 
administrator, you can skip this chapter. If you are 
the administrator of your own system, you need to 
understand the system files so you can look at and 
occasionally change them. 


Here’s a list of the system files you should know 
about: 

e /etc/passwd 

¢ /etc/group 

e¢ /etc/profile 

¢ /etc/inittab 

e /etc/vfstab 

e /etc/hosts 


e /etc/nodename 


You edit most of these system files by opening the file 
with an editor (such as vi) and adding a line toit. This 
section shows you what information you can add or 

change in each file and what this information means. 


You must log in as root in order to edit system files. 
Anybody can look at most system files, but only root 
can change them. 
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NOTE: Use extreme caution when 
changing system files. If you 
damage or lose a system file, you 
may have to reinstall Amiga 
UNIX. 
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Adding users to /eic/passwd 


The passwd file (pronounced password) is where you 
identify users who are allowed to log into your system. 
To add a user, you add a line for that user in the 
/etc/passwd file. 


Add a user to 


The following example shows a typical line from the 
/etc/passwd 


/etc/passwd file. 


login name name and 
user ID comments 


path to user's 
group ID home directory 


login shell 


Dogo Simpson Eng /home/joe:/bin/ksh _ 


What is it for? 


login name lower case, eight characters or less 
password leave it blank; you add it later 


user ID ereater than 100, less than 60001, no 
duplicates in the file 


group ID any number from /etc/group 
comment full name, phone number, comments 
home home directory (/home/username) 
login shell shell that starts on login 
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Passwords are in There’s another file, /etc/shadow, that contains the 

/etc/shadow passwords for all users. Only root can read 
/etc/shadow, and you must run a program called 
pwconv to update this file each time you edit 
/etc/passwd. 
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Adding groups to /etc/group 


Why use 
groupnames? 


What's in 
/etc/group? 
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Each user belongs to a group. Group numbers are as 
unique to groups as user numbers are to users. Your 
privileges in the UNIX system are based on your user 
ID and your group ID. 


Some users are logically grouped together; all the 
programmers, all the writers, or all the salespeople. 
Each member of a group has the same group 
privileges, which may or may not be the same as those 
of other groups. 


A primary advantage to setting up groups is to share 
files and common directories. You can make it so only 
people in your group can share your files. If someone 
from a different group tries to look at your files, UNIX 
denies them access. 


You can add as many groups as you need, any time 


you need. You do this by adding a line to /etc/group. 


group password people who belong 


group ID to this group 
number 
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What is it for? 


groupname meaningful name for the group 


password leave this field empty 


group ID any group number that is not in use 


usernames login names of people who belong to 
this group 
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Defining startup actions in /etc/profile 


What is 
/etc/profile? 
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The file /etc/profile contains information that the shell 
reads each time you or someone else logs in. The 
information gives the shell a "profile" of how to start a 
standard login session. 


NOTE: /etc/profile only affects sh, ksh, 
and rsh. It has no affect on csh. 


/etc/profile also automates some common tasks, such 
as displaying the message of the day. Amiga UNIX 
uses /etc/profile to configure your system’s default 
environment; your own .profile then modifies this 
standard environment to suit your personal needs. 


Here are some of the things the default 
/etc/ profile does: 
e set the search path 
e set the timezone 
e set the terminal type and characteristics 
e display the message of the day 
e test whether a user has mail 


e set default permissions for new files 
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Defining devices in /etc/inittab 


Define devices /etc/inittab contains information about init levels, 
and system virtual screens, and serial devices. Each line does 
processes in something different, but they all share a common 
/etc/inittab format. 


ID run level aes process 


$3:3.wait . 
/etc/rc3>/dev/console >2>&1 </dev/console 


ID name of this line 

run level init level in which action takes place 
action tells init how to handle process 
process command to execute at this init level 





Init levels in UNIX is always running in one of 7 modes (0-6 ors). § 


/etc/inittab puts it in single user mode, 2 puts it in multi-user 
mode, 0 shuts it down completely, and 6 executes a 
reboot to multi-user mode. These modes are defined 
in /etc/inittab and are called init levels. There are also 
three undefined init levels (a, b, and c) that you can 
change to create special ad hoc init processes. 
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Virtual screens 
and /etc/inittab 
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You change init levels by running the init command. 


For example, to bring your system to single user 
mode, login as root on F1 and use the init option for 
single-user mode. 


# Init ss 





When you run the init command, it reads /etc/inittab 
and executes the processes for the init level you 
specified. 


Virtual screens are defined in /etc/inittab, in different 
lines for each function key. 


con-23 respawn /etc/getty console console # system console 
screen - 3 
F2 23 respawn /etc/getscr -g2 -x640 -y200 term/con2 con #F2 


F3 23 respawn /etc/getscr -g3 -x704 -y464 term/con3 con #F3 


F4 23 respawn /etc/getscr -g4 -x704 -y464 term/con4 con #F4 


-F10 23:0ff:/etc/getscr -gl0 -x1024 -y1024 term/conl0 #F10 
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You customize your virtual screens by changing these 
lines. You change the settings in these lines to 
change the characters and colors on your monitor. 


Which virtual The following example shows which parts of a virtual 
screen settings screen inittab line you can change. 
do you change? 


settings you can change 


F1:23:respawn:/etc/getscr -g2.-x600 -y400 term/con2 # f1 


Virtual screen 


options What does it do? 


respawn/off Turn screen on or off 
-g number function key (2 through 10) 


-x number horizontal pixels (usually 320 or 640, 
or 1024 if you have Amiga high- 
resolution hardware) 


-y number vertical pixels (usually 200 or 400, or 


hardware) 


-O xxx background color, from 000 (black) to 
fff (white) 


-l xxx foreground color (000 to fff) 


-f filename font type and size (from the 
/usr/amiga/lib/fonts directory) 


term/conx name of screen (con2 through con10) 
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You can set the options for each of the nine default 
login screens (2 through 10, since function key 1 
always returns to the system console). If you turn a 
screen on (respawn) or off, you must type init q for 
init to read the /etc/inittab file and notice the change. 


serial devices You configure the default serial port (ser0) and any 

and /etc/inittab others you add (such as those on the A2232 card) in 
/etc/inittab. You can specify the serial device name 
and the baud rate. The following screen shows how 
you might configure the main serial port for a dumb 
terminal. 
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Define disks and file systems in /etc/vfstab 


Edit vfstab The /etc/vfstab file contains information about hard 
disks and file systems. You edit vfstab when you add 
a hard disk. UNIX then reads vfstab to automatically 
mount the hard disk when the sytem boots. 


fsck device 


resource Poe automount? 


Name 


/dev/dsk/c3d0sl /dev/rdsk/c3d0sl /mnt s5 1 no -- 


mount 
options 


What does it do? 


resource name | block device name 


fsck device character device name 


mount point directory in root file system where you 
want this disk mounted 


fs type type of file system (s5 is SystemV) 
fsck pass number for check, - for no check 
automount? y to mount automatically at boot tim 


mount options | special options to execute when the 
system mounts a file system 





192 Editing system files 


Network system names in /etc/hosts 


Add network The /etc/hosts file contains information about other 
system names to computers on your network. This hosts file is ikea 
/etc/hosts telephone directory; it lists a unique name and 


address for every computer in your "world". Each 
computer connected to the network must also have a 
copy of /etc/hosts, with all the computers it recognizes 
listed in this file. For convenience, most network 
administrators put the same hosts file on all the major 
computers and route the lesser computers through 
these points. 


During installation, you may have set up a two 
computer network. If so, the two systems you added 


appear in the hosts file. 
What do you put system system full name 


in /etc/hosts? address name or comments 


19582141  j9¢ = fice Jone’s cystcn 
149 6 218 2. 62 # Susan Lenard’s system 


Field What is it for? 


system address unique number 


system name name of your system 


comments has no effect on the hosts line; yo 
can put a user’s location or 
anything else you like; must star 
with a # sign 
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Naming your system in /etc/nodename 


What is /etc/ 
nodename? 


Use uname to set 
your nodename 
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The /etc/nodename file contains your system name. 
During the initial installation, you used the 
configuration script to name your system. 


You shouln’t edit /etc/nodename directly. Use the 
uname command to change your systemname. This 
also puts your systemname in the other files where it 
is needed, including /etc/net/ticlts/hosts. 


# uname -S systemname 





uname -S puts the system name into /etc/nodename 
and updates a couple of other important files. If you 
look inside /etc/nodename, you should see the new 
system name. 


S cat /fetc/nodename 


systemname 





Don’t forget to change the systemname in your hosts 
file and tell others about the change. If other users 
have a different name for you in their hosts file, they 
may not be able to communicate with or recognize 
you. 
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Maintaining your system 


Creating user accounts 





Log in as root Only root can add users 


Edit /etc/passwd Add a line that identifies users who can login to 
this machine 


Run pwconv Update associated files with new /etc/passwd line 


Create directory Create home directory for new user account 





Change ownership Change directory’s ownership and group from roo 
to that of new user 


passwd username Add a temporary password to user accounts 


shutting down your computer 





Always run shutdown before turning your computer off. You must b 


root and in the root directory (/). a 
# shutdown -y -g delay - 1 initstate g 
-y Skip questions; assume answer is yes FA 
delay Specify the number of seconds before shutdown S 
occurs 5 

init state Specify the initstate you want for your system afte 4 
3 


shutdown; 0 is power off, 6 is reboot 


Maintenance terms and concepis 





User accounts _ Lines in /etc/passwd that identify users who can lo 
in to this system 


Backup Copying important files and directory structures t 
another directory, floppy disk or tape. 


Terminal Monitor and keyboard that connects to the serial 
port, as an extra login screen, or dumb terminal 
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Why should you 
read this chapter 


Maintaining your system 


On a traditional UNIX system, one person is the 
system administrator and everyone else is just a user. 
Since Amiga UNIX is a personal workstation system, 
you take an active role as your own system 
administrator. After all, no one else is going to 
manage your desktop system for you. 


Administering a system isn’t as difficult as you might 
think. In fact, many "system administrators’ are 
simply users with a special password that lets them 
start the sysadm menu system. Most people who use 
a desktop UNIX system will at some point have to 
perform system administration tasks. 


This chapter introduces you to some techniques for 
keeping your Amiga UNIX system running smoothly. 
Unless you plan to administer a network of systems 
and users, this is all you need to know about system 
maintenance. If you are using a UNIX system that 
someone else is managing, you can probably skip this 
chapter. It covers both basic and advanced 
administration tasks, ranging from administrative 
commands you might use anytime to specific tasks 
you use less often. 
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What's in this Read this chapter to learn the following tasks: 
chapter? e adding and removing user accounts 
e adding hard disks to your system 

¢ adding terminals to your system 

e shutting your system down safely 

e backing up your files 


¢ using crontab to schedule tasks 
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Adding and removing user accounts 


Add new users The 6 steps for setting up user accounts are: 


login as root 


add line to 
/etc/passwd 


run pwconv 


create home directory 
for new user 


chown & chgrp the new 
directory to that of user 


create temporary 
password 





This section shows you how to add or remove a user. 


The /etc/passwd The /etc/passwd file contains a list of everyone who 

file has an account on your system. You control user 
accounts by adding, changing, or deleting lines in this 
file. 


NOTE: The passwd file is very important 
to the system. If you delete or 
damage it, be sure you create a 
new one before you log out; 
otherwise, you'll never get back 
in. 
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Typical line from 
/etc/passwd 


Users are defined 
in /etc/passwd 


What other files 
do you change? 
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login name name and 
user ID comments 


path to user's 
home directory 


login shell 


What is it for? 


login name lower case, eight characters or less 


password leave it blank; a program adds an 
encrypted password later 


user ID greater than 100, less than 60001, 
unique 

eroup ID any number from /etc/group 

comment full name, phone number, comments 

home home directory, /home/username 

login shell shell that UNIX starts on login; 
/bin/sh, /bin/ksh, /bin/csh, /bin/rsh 





After you enter a line for someone in your passwd file, 
you need to update another file, called /etc/shadow, so 
the two match. /etc/shadow contains the encrypted 
passwords for each user. If you look inside 
/etc/shadow, you see each user’s name, an encrypted 
password, and a couple of other pieces of information. 
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Run pwconv fo 
hide the 
password 
information 


Give new 
accounts a 
temporary. 
password 


Fortunately, you don’t have to worry about editing 
/etc/shadow, a program called pweconv does it for you. 
Run pweonv each time you add or remove users from 
/etc/passwd. 


Leave the actual password slot blank in /etc/passwd. 
This is so that pweonv knows the password slot is for 
a new user and hasn’t already been hidden. After you 
run pweonvy, the following message appears: 


pwconv:WARNING user account username has no 


password 





If you check the passwd file now, you see an x in the 
passwd slot. The /etc/shadow file now recognizes this 
user, SO you can add a password. 


Use the passwd program to add temporary 
passwords (such as "changeme') to the new user 
accounts. 


# passwd username | 


New password: 
Re-enter new password 
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passwd asks you to type the password twice, to 
confirm that you typed it correctly (since you can’t see 
it on your screen). 
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Make a home 
directory 


Change 
ownership of the 
home directory 
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You specified a path to a home directory in the passwd 
file. You also have to create that directory. If you 
want to group several users together, to provide a 
restricted environment or make them share all their 
work, you can put them all in the same directory. The 
system does not care if each user has his own 
directory; it just needs to know what directory that 
user will be using. The system does care about access 
privileges, however. The directory, and all the files in 
it, must have the same group or other access 
privileges. 


Use the mkdir command to create a home directory 
for new users. Usually the home directory is 
/home/username. 


Since you are logged in as root, this new directory 
belongs to root. You want to change its owner and 
group, so it properly belongs to the new user. 


# chown username directoryname 


# chgrp newgroupname directoryname = 





You now have a new user account, complete with a 
login name, login shell, group, password, and home 
directory. If you are setting up accounts for other 
users on your system, repeat these steps, and tell 
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Change user 
information 


Maintaining your system 


them what temporary password you gave them. They 
can change their own passwords by using the passwd 
command after logging in. 


You can change a user’s information any time by 
editing his line in /etc/passwd. Any time you change 
a user’s information, you may have to make other 
changes to keep the user’s world in line with the 
/etc/passwd file (such as move his files to a new 
directory or change the group on his old files). 


If you change a user’s name in /etc/passwd, you must 
run pweonvy again. Make sure the password space in 
the user’s line is empty before you run pweconvy; 
otherwise, the program doesn’t think of it as a new 
account. 
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Remove users Follow these three steps to remove a user from your 
system: 
e delete the line from /etc/passwd 
* run pwconv 


° usermdir to remove the home directory (unless 
it is a shared directory) 


NOTE: The rmdir command doesn’t let 
you delete a directory that has 
files init. You must remove all 
files and subdirectories first. 
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Adding a hard disk 


What is a SCSI SCSI stands for Small Computer Systems Interface. 

disk? Tape and hard disk drives are common examples of 
SCSI devices. You connect SCSI devices to your 
system simply by connecting a cable to the SCSI port. 
You can also link up to 7 SCSI devices together to 
form a chain. 


What does if fake There are nine steps to add a SCSI disk. 
to connect a 


ick? 
SCSI disk’ set disk’s SCSI address 


connect disk to SCSI bus 


use ddformat to format 


the disk 


use ddsize to see how 
big the disk is 


use rdb to partition the 





use mkfs to create a 
file system 


create a mount directory 
on your root file system 


add mount information 
| to /etc/vfstab 


use mount to mount 
the new disk 
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Change the Each SCSI device must have a unique SCSI “address , 

address on the and all of them must be turned on if any of them are 

new disk to work. The following table lists the addresses 
already in use on a standard Amiga. 


Device that uses it 


internal hard disk 
external tape drive 


SCSI disk controller 





Make sure the new SCSI disk doesn’t use one of these 
numbers or any others already in use. 


You may need to set some jumpers on the disk to 
change its address. Check the disk manufacturer’s 
instructions for setting the SCSI address. Use 1 if this 
is the first external SCSI drive. 
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Connectthe SCSI 
cable 


Give the disk a 
device name 
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The 3000UX has a built in SCSI port. You can connect 
any external SCSI drive to this port. 





Amiga UNIX provides many predefined disk device 
files in /dev/dsk. 


SCSI disk c6d0s0 is your default hard disk. It has at 
least three partitions on it: Unix_Root, Unix_Swap 
and Unix Boot. Each letter in the device name refers 
to a specific feature of the disk. The c refers to the 
SCSI device number (or address), the d refers to the 
disk number, and the s refers to the partition number. 
Thus, if your internal disk is c6d0s0 with 3 partitions, 
the partition names are c6d0s1, c6d0s2, c6d0s3 
respectively. 
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device disk 
directory directory 


fdev/dsk/cld0sO 


Parts of a device 
name 


SCSI Drive Partition 
address number number 





Any device file with an sO (like c4d0s0) refers to the 
entire disk. Any device with an sl-s7 (like c4d0s3) 
refers to a partition on the disk. 


What does it do? 


device dir directory off root called /dev 


disk dir directory off /dev called /dsk 
SCSI address whatever you set the jumpers to 


drive number identifies the drive 





partition # specific number for each partition 
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Use ddformat to If your disk isn’t already formated, you should do so 
format the disk using ddformat. To format a disk, type ddformat 
followed by the name of the device you are formatting. 


# ddformat jdev/den/eiees 
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Use rdb fo create You use rdb (rigid disk block) to perform three disk 
and show partitioning tasks 

partitions e display information about the current partitions 
(rdb devicename) 


¢ create a basic partition 
e adda variety of custom formatting features to a 
hard disk partition 


The following example shows how you might put one 
partition on a 100 megabyte disk. 


create device start length 
option name block 


# xrdb -c /dev/dsk/cld0s0 partitionname 10 


What does it do? 


-C tells rdb to create partitions; always 
create using sO (the whole disk) 


dev name file in /dev/dsk for this disk 

partitionname | type a name for this partion 

start block point on disk where partition starts; 
leave about 50K (100 blocks) free at 
beginning of the disk 

length length (in 512 byte blocks) of this 
partition. 
length = ddsize - start block 





208 Maintaining your system 


Make as many Most Amiga UNIX computers ship with their disks 

partitions as you divided into three partitions for Amiga UNIX. The 

need first partition’s device name is c6d0s1, the second is 
c6d0s2, and the third is c6d0s3. You can use the rdb 
command to set up partitions on your own disks. 


NOTE: rdb destroys existing partitions, 
which means you can no longer 
access files on the disk. Use rdb 
with care. 


You can only run the rdb command on the entire disk, 
which is cld0s0O in our examples and c6d0s0 for the 
standard Amiga disk. 


You can make two 50 megabyte partitions on the disk 
with one command. 


device 
name start 


00 102400 


name of 
partition | partition 2 
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rdb options 
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The starting point of the second partition (102500) is 
the starting point of partition 1 (100) plus the length 
of partition 1 (102400). The length of partition 2 is the 
same as partition 1 in this case because you are 
dividing the disk in half. 


Each partition you put on a hard disk is treated as a 
separate file system. You mount each partition (file 
system) on its own directory. 


The following table describes more rdb options. 


Make selected partition non-bootable 
Make selected partition bootable 
Create a new rdb 

Set number of custom boot blocks on 
selected partition to n 

Set file system type on selected 
partition to n 


Display information about current 
partitions in a long format 


Select partition n 
Set boot priority on partition to n 
Set sectors per track to n 


The following examples illustrate some more uses for 
rdb. 
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Three partitions 
and 70 sectors 
per track 


7Osectors create deviceis partition | 
per track SCSI 1 


ce “bab “s 70 —¢ dou /dek/e1dds0 ak Root 140 178710 
Unix Sue 178800 18900 Unax_ Boot 197750 728) i 


partition 2 partition 3 





This example creates an rdb on SCSI disk 1 with 70 
sectors per track and three partitions. Each partition 
is given a name, a starting position, and a size (in 512 
byte blocks). 


The previous command produces the following rdb 
list. Note that the settings in the list exactly match 
the instructions you gave rdb. 


# rdb -H /dev/dsk/cld0s0 


# Name — Start 0 ‘Size | 


-1:Unix_Root 140 178710. 87 ‘meg 


2: Unix_Swap © 178850 18900 9 meg” 


3: Unix_Boot 197750 7280 3meg 
fo oo 
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Customize a 





bootable a ares ss 
+4: selec isk is 
partition partion 3 bootable SCSI 0 
This rdb command makes partition 3 on SCSI disk 1 
a bootable partition. 
Define an 
| select 2 custom 
AmigaDOs partion 3 boot blocks disk Is 
partition 


make It file system type SCS! 0 
bootable is AmigaDOS 


# rdb -p 8 -B -C 2 -F 0x444f5300 /dev/dsk/c1d0s0 





This rdb example makes partition 3 bootable with 2 
custom boot blocks and sets its filesystem type to 
DOS\0 (0x444f5300 is hex for DOS\O) for use with 
AmigaDOS. 
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Make a 
filesystem on the 
disk 


Use the mkfs command to build a file system on an 
external disk (ddformat erases the disk; mkfs builds 
an empty file system on it). Run mkfs for each 
partition on your disk. You specify the partition size 
in 512 byte blocks. The following example shows what 
to type for a 100 megabyte disk with 1 partition. 


make a on SCSI that is 204800 
system 5 device | blocks (100 Mb) 
filesystem long 


# mkfs -F s5 /dev/dsk/cld0sl 204800 





Create a mount 
directory on the 
internal drive 
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NOTE: You should never run mkfs on sO 
(the whole disk). You should only 
mkfs on partitions (sl-s7). 
Likewise, you should never run 
rdb on anything but sO. mkfs 
works on partitions; rdb works on 
disks. 


Create a directory on your main hard disk. Call it 
something like /usr/mnt. This is where you are going 
to mount the new disk. If you mount the drive on an 
existing directory, anything in that directory will be 
covered, and is therefore unavailable until the disk is 
unmounted. 


Add the file system information to /etc/vfstab. Once 
you put the line in vfstab, you can refer to the disk by 
its mount directory, rather than by its longer device 
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Define the file name. Also, you can make the mount automatic, so 
system in the external disk partitions are mounted whenever 


/etc/vfstab the system boots. 


fsck device file system — qutomount? 
mount 'YPe fsck 


resource 
Name 


/dev/dsk/cld0sl /dev/rdsk/cld0sl /usr/mnt s5 1 no --— 





Labelit lets you label your new filesystem. The label 
prevents the mount command from giving you an 
error message when you mount the new filesystem. 
You use the mount directory name as the label. 


Run labelit on the 
filesystem 


labelit partition mount directory 
command (filesystem) name name 


# labelit /dev/dsk/cid0sl./usr/mnt | 
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Mount the disk 


Use the mount command to mount the disk. 


mount directory 
command name 


# mount /usr/mnt 





Expand the 
lost+found 
directory 


mount reads /etc/vfstab, finds the line for this 
directory, and mounts it. . 


After you mount the disk, you can ed into the mount 
directory, just like any other directory, and start 
using the disk. This is what "virtual file system" 
means; the system does not care what disk drive or 
disk partition you are using. You simply choose files 
and directories; it keeps track of where they are. 


The lost+found directory on your mounted partition is 
reserved for use by fsck to save corrupted files. (Most 
users do not need to understand lost+found; damaged 
files are automatically thrown away during shutdown 
and reboot). Experienced administrators can try to 
recover lost+found files, but it is not an easy process. 


If you think you might want to use lost+found, expand 
the empty directory by running mklost+found 
directoryname. 


/# mklost+found /usr/mnt 
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Using the UNIX shells 


Shell scripts 


Start-up files 


Shell and 
environment 
variables 
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You can use shells to run a sequence of instructions 
automatically. The sequences are actually executable 
files called "shell scripts". Shell scripts use shell 
commands and common programming language 
constructs (like if, else, do, while, break, and case). To 
run a shell script, type the name of the script. 


Examples of shell scripts are .profile (run by ksh) and 
login (run by csh); both are start-up files you can 
create in your home directory. The system start-up 
file is /etc/profile, but you can create a start-up file of 
your own by copying /etc/profile into your home 
directory as .profile (or .login for csh) and editing it to 
suit your needs. Each time you log in, the shell will 
set up your computing environment by reading the 
start-up file. 


A start-up file contains shell and environment 
variables which define how your terminal 
environment should behave. Shell variables are used 
by shell programs, shell scripts, and the shell itself. 
For example, one shell variable, PS1, determines 
what your prompt looks like. You can define the 
prompt as anything you want: a dollar sign, your 
system’s name, your current path, or something else. 
Any variables that are used by shell programs (like vi 
and mail) are also called environment variables. A 
chart on the next page lists some of the most common 
shell variables. 
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Shell variables 


ENV define the pathname of the file 
containing alias and set-up 
commands 

HISTSIZE define the number of previously 
executed commands kept in the 
command history file 

HOME define the pathname of your login 
directory 

LOGNAME define your login (username) 

PATH define the search path for finding and 
executing commands 

PS1 define your shell command prompt 
string; the standard command promp 
for the Korn and Bourne shells is $; 
for the C shell it is %. 
define your shell input prompt string 
the standard input prompt for all 
shells is > 
define your login shell 
tell the shell what kind of terminal 
you are using 
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Display variables Display shell and environment variables with the 
following commands: 


echo $variable| display the value assigned to a shell or 
an environment variable 
display the current environment 


variables and their settings only 
display the current environment and 
shell variables and their settings 
(Korn or C shell) 

setenv display the environment variables 
and their settings only (C shell) 





Change You can define variables permanently or temporarily 
variables for a session. To change a variable permanently, edit 
permanently the .profile or .login files or create a shell script that 


you can run when you want the variable to change. 
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Change shell To define shell and environment variables 
variables temporarily in ksh and sh, use the following 


temporarily commands: 


variable=value assign a value to the specified 
shell variable 


variable=value 

export variable assign a value to the specified 
variable and export the variable 
to the shell environment 





To define shell and environment variables 
temporarily in csh, use the following commands: 


Command Description 


set variable=value assign a value to the specified 
shell variable 
env variable=value assign a value to the specified 


environment variable 

setenv variable=value | assign a value to the specified 
variable and export the value 
to the shell environment 





Refer to the env, set, and setenv Command 
Reference pages for more information. 
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History file The Korn and C shells maintain a history file of 

commands commands you previously executed. The number of 
commands kept in this file depends on the value 
assigned to the HISTSIZE environment variable. You 
can display your command history file and execute 
commands listed in the file using the following 
commands: 


history display previously executed 
commands 


execute the previous Korn shell 
command 

execute the command referenced by 
command line number nn in the Korn 
shell history list 


r command execute the most recent command in 
the Korn shell history list 


execute the previous C shell command 
execute the command referenced by 
command line number nn in the C 
shell history list 

fcommand execute the most recent command in 
the C shell history list 





220 Maintaining your system 


Processes Each background process you run is called a job. 
When you create a background process in the Korn or 
C shell, the shell assigns to it a job number (enclosed 
in square brackets) and a process ID (PID) number. 
The ksh, csh, and jsh shells allow you to terminate a 
job, stop ajob, and control whether it runs in the 
foreground or background. These shells also let you 
list your active background jobs. 


list active background processes 
under jobs control 

terminate job number n 

stops a job that is running in the 
foreground 

place a job that is running in the 
background into the foreground, or 
restart a stopped job and runs it in the 
foreground 

place a foreground job that has been 
stopped into the background 

place background job number n into 
the foreground 

place foreground job number n, which 
has been stopped, into the 
background 
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Configuring your system 


Change the time 
and date 
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The installation tape sets up a standard UNIX system, 
but there are many ways to customize both the system 
and your individual user account. A few common 

customization options are summarized in this section. 


To set the timezone, edit /etc/TIMEZONE. The 
/etc/TIMEZONE file contains a variable that you set 
to be your default timezone. This variable includes 
the abbreviation for regular and daylight time and the 
hours from Greenwich Mean Time. 


regular hours from daylight 
time Greenich Mean Time time 


Greenwich 
Europe 
Atlantic 
Eastern 
Central 
Mountain 
Pacific 
Yukon 
Alaska 
Bering 
Hawaii 





To change the date and time, use the date command. 
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Secure the 
system 


Customize your 
login 
environment 
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+ date. mmddHHMM 





If you don’t specify the year, date assumes you mean 
the current year. You can also type date without any 
arguments to see the current date and time. 


When you first started Amiga UNIX, you had the option 
of assigning a password to the default login accounts. If 
you didn’t assign one then, you can do so now by 
running a program called passwdall. This program 
asks for a password and secures every system account 
with this password. If you want to remove the 
password from all system accounts, type passwdall -d. 
You must be root to run passwdall. 


When you first start Amiga UNIX, you are working in 
the default environment we set for you. You can change 
your default environment by creating and modifying a 
file called .profile in your home directory. 


Every time you log in to your computer, your login shell 
looks for a startup file in your home directory. It 
contains information specific to you, such as what your 
prompt should look like and whether you want OPEN 
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Make a custom 
ksh prompt 
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LOOK to start automatically. The Bourne and Korn 
shells use .profile; the C shell uses a file called .login. 
Both serve the same purpose. 


If you use ksh, put the following lines in your .profile. 


system colon | 
name current directory 


PS1=‘uname*:’ \SPWD>’ 
export PSl. 





These lines make your prompt display your system 
name and current path, as in the example below. 


amiga: /home/joe> 
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Make a custom 
csh prompt 


Set up aliases 





You can also make the same custom prompt in the C 


shell, by putting slightly different commands in your 
login file. 


change system 
define Prompt name colon 
an alias ‘TO include current 
directory 


alias setprompt ’set prompt’="‘uname* ‘pwa te! 


alias cd ’chdir \'*  , setprompc’ 


define change and reset 
an alias directory prompt 


set prompt 
the first time 


You can assign an alias that invokes any UNIX 
command. You define aliases in your .profile (or .login 
for C shell). For example, you could create an It 
command that always displays the long format by 


time (Is -It). 


alias lt='ls -l1t’ 
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Virtual screens 


Install optional 
parts of Amiga 
UNIX 


Use cpio to copy 
the optional files 


226 


You can change the look of each virtual screen by 
changing its font size and background color. You 
change the virtual screens by editing lines in 
/etc/inittab. See Editing system files for help editing 
/etc/inittab. 


The tape that came with your Amiga computer is 
divided into four parts: 

e Amiga UNIX 

e X Window System development tools 

¢ complete AT&T documentation for Release 4 


e¢ public domain source code 


The only part that is installed automatically is Amiga 
UNIX. You can install the other three if you need 
them. You need about 55 megabytes of free disk space 
to install all the optional files. See Installing Amiga 
UNIX for more information. 
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Adding terminals to your system 


How many 
terminals can 
you add? 


Add aterminalto 
the serial port 
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With a normal Amiga UNIX license, you can have two 
users logged in to the system at a time. The other user 
can be over a network, using your virtual screens, or 
on a terminal attached to your Amiga. The terminal 
can be another Amiga, a PC, a dumb terminal, or a 
different kind of computer. If you want more than one 
terminal, you can add a serial port expansion card to 
your system. 


You need to do three things to add a terminal: 


¢ connect it with a cable to the serial port 

e change the port setting in /etc/inittab 

e change the settings on the terminal to match the 
Amiga serial port 


You can then use this terminal just like your monitor, 
except it will not have virtual screens. 
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You need a serial You can make or buy a 25 pin serial cable. Only a few 
cable of the pins are necessary. This diagram shows the 
configuration for the cable. 





Configuration for serial cable 


Change the You need to set the baud rate and terminal name in 


serial line in /etc/inittab and change the action from off to 


/etc/inittab respawn. 


Main serial Action Put a getty on term/ser; 
port baud rate is 9600 


ser0:23:respawn:/etc/getty term/ser 9600 #main ser 





See Editing system files earlier in this book for more 
information. 
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Match terminal 
settings 
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NOTE: After you make changes to 
/etc/inittab,type init q at the 
command prompt. This notifies 
init to check the new settings. 


The hardest part of setting up an extra terminal is 
getting the cable and terminal settings right. If you 
use the configuration on the previous page, you 
shouldn’t have trouble with the cable. Setting the 
terminal correctly to match the computer cable could 
take a while. 


Terminals vary from manufacturer to manufacturer. 
If you have trouble with the terminal settings, contact 
the company that manufactured the terminal. You 
won't get a login prompt on the terminal until all 
settings are correct. 
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shutting down and restarting your computer 


What is 
shutdown? 


Who can run 
shutdown? 


How do you run 
shutdown? 
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You should never just turn off or reboot your Amiga 
UNIX computer. Always run the shutdown command 
first. shutdown brings your system down safely by: 


e letting people know the system is coming down 
e killing running processes 
e saving all current memory blocks to disk 


¢ switching the system to single user mode. 


Also, always run shutdown before doing any 
maintenance on your system, such as adding disks or 
connecting tape drives. If you don’t run shutdown, 
the current activity never gets closed or saved 
properly, and you may lose disk files during the fsck 
cleanup when you reboot. 


Only root can run shutdown. 


You shutdown your system by typing the shutdown 
command, using any or all of 3 options: skip prompts 
(-y), delay in seconds (-g), and init state (-1). 


# shutdown -y -g delay -1 initstate 
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What does it do? 


-y skip confirmation prompts 


-g delay seconds before shutdown occurs 


-1 initstate lets you halt the system completely 
(0), go into single-user mode (S) for 
maintenance, or reboot (6) 





Normally, simply typing shutdown and using the 
default options is sufficient. 


What happens After the delay interval, the shutdown command 

after you start without any options brings the computer down to 

shutdown? single-user mode. You can do one of three things at 
this point: 


e type CTRL-D to restart the system 
e login as root 


e turn the power off 


Restart your If you log in as root, most likely to do maintenance, 

sysiem your console screen is the only available screen. 
When you are ready to restart multi-user mode, type 
init 2. Virtual screens won’t work in single-user 
mode. 
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Backing up your files 


Where should 
you put the 
backup? 


How do you 
make backups? 


If you plan to use 
floppy disks for 
your backup... 
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You should get in the habit of backing up your 
important files by making duplicates of them. You can 
put the duplicates somewhere else on your hard disk, on 
a floppy disk, or on a tape. To completely protect your 
files, you should keep copies of the files in more than 
one place. 


You use the cpio command to make backups. By 
varying the options you use with cpio, you can write 
files (and whole directory structures) to a device, get a 
list of files on a device, and restore files from a device. 
That device can be a hard disk, a floppy disk, or a tape. 


The rest of this section shows you how to use the cpio 
command to backup files. 


If you plan to use floppy disks for your backup, you must 
first format them using the fdfmt command. 


6 fatmt > /dev/rdsk/f£a0t 





If the backup requires more than on floppy disk, cpio 
prompts you to change the disks. Be sure you have 
enough formatted disks before you start. 
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Back up files 


Examples of 
backing up files 
to hard disk, 
tape, and floppy 
disk 
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The simplest way to save important files is to copy an 
entire directory structure. You use a find or ls 
command to list files, pipe the filenames into cpio - 
ocv (cpio -ocv -O for floppy disks and tape), then 
direct the output to your backup location. 


pipe the contents Into then redirect this 
of joe’s home Cpio backup to a device 
directory 


find /home/ joe -depth -print | cp1io_-ocv > device 


copy out write header verbose 
in ASCII format (list filenames) 





The following examples show what you type to backup 
files to a directory on a hard disk, a floppy disk, or a 
tape. 


Sete as device is 
device Is a file floppy disk 


on your hard disk 


: find onli jee bgp epee A cpio. -ocv > oe 


find /home/joe -depth -print | plo: Cv 0 pi gev dsk/ td) 


a ee print | 


device is 
a tape 
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List the contents You look at the contents of your backup by redirecting 
of your backup the output of a device (hard disk, floppy disk, or tape) 
into cpio -ictv. 


verbose 


print table of (list filenames) 
contents 


S$ cpio -ictv 


copy in write header 
in ASCII format 





The following examples show what you type to look at 
the contents of your backup on a hard disk, a floppy 
disk, or a tape: 


Examples of device Is a file 

listing the on your hard disk 

contents of a 

hard disk, tape, | SU10 -1cuy < /tmp/£1lename 
. CO10 -1cty /dev/dsk/fd0 

OF floppy disk Colo -1ctv < /dev/rmt/4 


device Is 
floppy disk 


device is 
a tape 
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Restore files 


Examples of 
restoring files 
from a hard disk, 
tape, or floppy 
disk 
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The cpio command restores files and directories to 
exactly where it found them, overwriting anything 
currently there. You restore files by redirecting the 
output of a device (hard disk, floppy disk, or tape) into 
cpio -imdcuv (cpio -imdcuv -B for tapes). 


COpy 
keep previous = unconditionally verbose 
change time (list filenames) 


< /tmp/filename 


create 
COpy IN directories 
as needed 


write header 
in ASCII format 


The following examples show what you type to look 
restore your backup from a hard disk, a floppy disk, or 
a tape: 


device is a file 
on your hard disk 


CploO =imdcuy < /tmp/filename- 
Colo =imdeuyv.-B— <-/dev/rme/4 
5 Cpio -imdcuy < /dév/dsk/td0 ~~ 


device is device is 
floppy disk a tape 
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scheduling tasks using cron 


What is cron? 


What does cron 
do? 


How do you use 
cron? 


Who can create 
a crontab? 
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The cron program runs commands for you at 
scheduled times. You can schedule processes to run 
when you aren't working on your computer, such as in 
the middle of the night, or at regular intervals during 
the day, such as every half hour. 


You could have cron automatically backup your home 
directory to another directory, display the time on 
your screen, or print your personal calendar. You can 
tell cron to do this on any given: 


° month 

e date 

¢ day of week 
e hour 

¢ minute 


The cron process is constantly working in the 
background, so you don’t do anything directly with 
cron. Instead, you put the commands you want to 
execute and the times to execute them in a crontab 
file. The cron process reads the crontab and executes 
the commands at the specified times. 


Any user can create a crontab. If you want to prevent 
users from creating a crontab, put their usernames in 
/usr/lib/cron/cron.deny. You must be root to edit 
/usr/lib/cron/cron.deny. 
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What are the There are six default crontabs in 


default /var/spool/cron/crontabs, containing scheduled 
crontabs? maintenance procedures run by various system 
accounts: 

° adm 

° Ip 

e root 

¢ smtp 

° sys 

° sysadm 


These crontabs are reserved for special system uses, 
and only root or the crontab owner can change them. 
After you create a crontab for yourself, it appears in 
this directory, with your username as its filename. 


Create a crontab You use the crontab -e command to create a crontab. 
After you type crontab -e, an editor appears into 
which you type the 6 crontab columns separated by 
tabs. Five of the columns define the scheduled time 
and the sixth is the command to be executed. 


crontab format 


minute weekday command 
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Use the crontab 
command 


sample crontab 
entry 
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What can you put in it? 


minute 0 to 59 or * for every minute 


hour hour of day in 24 hour format (0-23) or * 
day day of the month 1-31 or * for every day 
month month of the year 1-12 or * 

weekday 0 - 6 (0 for sunday) or * for all days 
executable | command or executable file name 





The day and weekday work together, one does not 

have priority over the other. You can schedule a job to 
run on the 1 2th of each month, Mondays and Fridays. 
If the 12th falls on a Tuesday, cron still runs the job. 


The following example shows a crontab that executes 
filename at 6:30 AM every Wednesday. You can also 
put commands directly into the crontab. 


all months Third day of 
30 minutes ofthe year the week (wednesday) 


past the hour 


crontab 
3 /f/home/joe/filename 


all days of ic fj 
er ia paneer execute this file 
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Edit an existing 


Use crontab -e to edit an existing crontab. 
crontab 


-e displays crontab 
information in editor 


S crontab. -e 








After you make your changes to the crontab, exit the 
editor as you would normally. If you made a mistake 
in the crontab, a message appears telling you so. You 


can edit the crontab to add lines, delete lines, and 
change lines. 


Other crontab The following table lists two other useful crontab 
options options. 


What does it do? 


List the contents of your crontab 
Remove or delete your crontab from 
/usr/spool/cron/crontabs 





Experiment with 


There are many ways to use a crontab. Experiment 
the cron system 


with the cron system by scheduling commands and 
your own executable files. 
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UNIX accounting files 


Whai are the 
UNIX accounting 
files? 


Accounting files 
accumulate 
data 


Periodically 
check the 
accounting files 
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The UNIX system uses a complex accounting system 
for tracking things such as system usage by process or 
user, disk usage, and the amount of time a user is 
logged in. There are many other accounting files, 
many of which you will never have to use. 


Some of the accounting files are active by default, 
which means they are accumulating data and possibly 
using up valuable disk space. It’s not important that 
you know how to use and interpret every accounting 
file, but it is important that you know how to find the 
ones that are active. 


If your disk starts getting full, you should check the 
size of these accounting files. If they are 
extraordinarily large, remove, empty, or edit them. 
The table on the following page lists the more common 
accounting files and their purpose. 
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The most 





common : 
/var/adm/spellhist get line when spell runs 
/var/cron/log cron’s log 
/var/saf/log saf log 
/var/saf/ttymon/log port monitors log 
/var/adm/sulog tracks the su command 
/var/adm/lastlog last login information 
/var/adm/wtmp login history 
/var/adm/wtmpx login history 
/var/spool/smtq/LOG smtp (network mail) log 
/var/|p/logs/IpNet network printing log 
/var/|p/logs/lpsched print scheduler log 
/var/\p/logs/request print requests log 
/usr/public/lib/news/log Usenet news log 
/usr/public/lib/news/errlog | Usenet news error 
Some Some accounting files are automatically trimmed by 
accounting files cron jobs. Most of these files are found in directories 
are in /usr/spool/uucp. 


automatically 
trimmed 
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Troubleshooting 


Problem Solution 


Can’t use one of Make sure its action is set to respawn in /etc/inittab. 
the virtual 
screens 


Can’t use any of Your system is in single user mode. 
the virtual 


screens 


Can't kill a Make sure you typed the right process ID number 
process (PID). 


Use the -9 option with the kill command. 


The process doesn’t belong to you. Log in as root, then 
try killing it. 


Can’t display 
other users’ 
processes 


Use the -e option with ps. 


Can’t open a Log in as root. Only root can change system files. 


system file for 
editing 
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Problem 


You created a 
new user 
account, but 
Amiga UNIX 
doesn’t 
recognize it 


Can’t work with 
files after 
creating a new 
user account 


You changed 
shells, now some 
commands don’t 
work 
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Solution 


Run pweonv. Every time you add a new user, you 
have to run pwconv to update /etc/shadow. 


Make sure you entered the line properly in 
/etc/passwd. 


Make sure there was no password entry in 
/etc/passwd before you ran pweonv, and that there is 
only an x in the password spot after pwconv. 


Root created the user account, so root owns the 
directory. chown and chgrp the directory so that 
you (or the user) owns the directory. 


Each shell is slightly different. sh and ksh are 
similar, but esh and ksh both have some features 
that sh doesn’t share. The only way around this 
problem is to change back to the shell with which you 
are familiar. 


243 


Problem 


SCSI disk doesn’t 
work 


Can’t make a 
serial terminal 
work 


Can’t shut down 
your system 
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Solution 


The SCSI address is already in use. Set the device 
address to one that is not in use. 


Make sure you ran rdb only on sO (the whole disk). 


Make sure you mkfs and mount only with sl through 
s7 (partitions). 


The device name is wrong. Check the name again. 


Baud rate is wrong in /etc/inittab, or port is still set to 
off (instead of respawn). 


Cable configuration is wrong. 


Terminal settings don’t match your system settings. 


You aren’t logged in as root on the console (F1). 


You specified the shutdown options incorrectly. 


You're not in the root directory (/). 
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Problem Solution 


Can’t format or Make sure the write protect tab is closed. 

copy to a floppy 

disk 

Customizing Log out then log back in. 

aliases or 

prompts doesn’t Be sure you're using the right startup file; .profile for 


work ksh and sh, .login for csh. 
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UNIX command reference 


File Commands 


Directory Commands 


cat display contents cd move to home directory 
cp copy cd... move up one directory 
more’ display one page ata’ find search for a file 

time Is list files in directory 
mv rename or move mkdir make a new directory 
rm delete pwd show current directory 


iad wildcards to match rmdir remove empty directory 
patterns in a file- 





Print Commands 


Disk Usage Commands 





cancel stop a print job df disk space used and free 

Ip print fdfmt format 3.5" disk 

Ipstat printer status tar copy to, retrieve from 
cpio list files on disk or tape 





You... by using... 
backup files tar or cpio 
break a process kill or CTRL-C 
copy files cp or tar 
change virtual screens ALT-functionkey 
check disk usage df and du 
check process status ps 


check user status 
communicate with others 
create a directory 
display or type a file 

edit files 

list files 

logout 

read on-line help 

set your password 


finger, who, or whodo 
elm or talk 

mkdir 

cat, head, more, or tail 
vi 

Is 

exit or CTRL-D 

man 

passwd 
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Administrative Commands 





fsck examine and repair the hard disk 
init change run level 

Ipadmin set up or change a printer 
shutdown — shutdown the system 

uadmin reboot or shutdown the system 


uname -S name your system 


Network Commands 





ftp start the file transfer program 

ping determine if a system is active 

rep copy files between systems (remote copy) 
rlogin login to another system (remote login) 


Commands Used to Configure Amiga UNIX 





alias customize command names and shortcuts 
chgrp change the user group a file belongs to 
chmod change file access permission 

chown change file ownership 

In link a ‘fake’ file to a real file 

lpadmin configure the printers attached to your system 
mkfs create a file system 

mount mount a partition 

passwdall assign a system password 

pwconv hide user password information 

set set and display environment variables 
stty set or display system input/output options 


uname name your system 


UNIX command reference 


Why read this This chapter contains: 


chapter? e aquick reference chart of commands grouped by 


function 


e brief descriptions (including formats, 
restrictions, and examples) of commonly used 


commands 
¢ charts of special characters you can use in 
commands 
Shell differences The Korn shell (ksh) is the preferred shell because it 


is an enhanced form of the standard shell (sh). The 
descriptions in this chapter are based upon how 
commands work in ksh. The C shell (csh) is not 
compatible with sh, so some commands work 
differently in csh, in particular: alias, history, 
oladduser, set, setenv, and type. Special notes 
included in the descriptions explain how these 
commands work differently in C shells. 
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Command Reference Chart 


Key 
phrase 


active users 


active processes 
alter screen 

bring down system 
calculator 
calendar 

cancel 

change directory 
change ownership 
change permissions 
clear screen 

clock 
communicate 
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Related 


command 


who 


who am i 


jobs 
ps 
whodo 
color 
set 


shutdown 


be 

cal 
cancel 
kill 

cd 
chgrp 
chown 
chmod 
clear 
date 
elm 
mail 
mesg 
m 
talk 
wall 


Description 


user status 

display user information 
list your processes 

list active processes 
display user process status 
change screen color 
change terminal variable 
shutdown system 

binary calculator 

on-line calendar 

cancel a print request 
cancel background process 
change directory 

change group 

change owner 

change permissions 

clear screen 

display date and time 
electronic mail 

electronic mail 

message setting 

on-line news 

on-screen message system 
send message to all users 
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phrase 


copy output to file 
create directory 
create file 


" 


customize command 


disk 


display directory 


" 


echo 
editor 
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copy file or directory 
copy to/from device 
copy to remote system 
copy to/from device 
copy output to file 
create directory 
redirect output to a file 
visual editor 

customize commands 
display disk allocation 
display disk usage 
format disk 

repair disk problems 
display file contents 
display beginning of file 
display file contents 
display a page at a time 
display a page at a time 
display end of file 
display disk usage 
display directory contents 
display current directory 
echo output 
file editor 
stream editor 
file editor 
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Key Related 
phrase command |Description Page 


mkfs 
mount 
rdb 
file type file 
find 


file system 


apropos 
find 


help 
link 


move 
network ftp 


ping 

rcp 

rlogin 
telnet 
oladduser 
olinit 


OPEN LOOK 


" 


password passwd 
passwdall 
pwconv 


past processes acctcom 


. history 
pathname type 


" tty 
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create file system 

load file system 

partition hard drive 

display file type 

find term in man pages 

find file or directory 

find term in file 

on-line reference 

link files or directories 
move/rename file or directory 
File Transfer Protocol 

check status of system 

copy to/from another system 
log in to another system 

log in to another system 

set up OPEN LOOK defaults 
start up OPEN LOOK 

change password 

change or delete all passwords 
update /etc/shadow file 
display past process statistics 
display command history 
display command pathname 
display terminal pathname 
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306 
309 
323 
280 
254 
281 
288 
303 
295 
oll 
286 
O17 
322 
320 
348 
J12 
o13 
O14 
old 
320 
252 
290 
300 
3J49 
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Related 
command |Description 





printing cancel cancel a print request 257 
Ip print files 296 
lpadmin define print services 297 
Ipstat display print request status 299 
pr format a file 318 
rm remove files 326 


rmdir remove directories 327 





remove 


" 





rename 





mv rename/move file or directory 311 

















sort sort lines of screen or file 341 
SC spreadsheet program 330 
crontab execute scheduled tasks 269 
init initial set-up process 291 
olinit initialize OPEN LOOK 313 
sleep suspend process 340 
stty change/display terminal info 342 
tty display terminal pathname 349 
xhost list systems with access to X 357 


sort 
spreadsheet 
start-up 














suspend process 
terminal information 


" 















xterm 
xset set user preferences 358 
xterm create an Xterm window 360 
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acctcom 





Description 


Restrictions 


Formats 


Examples 


252 


list process statistics - 


Provides statistics about system usage. Searches the 
process accounting files and displays records of past 
activity. acctcom reports only on processes that have 
been terminated. 


acctcom only works if you turn on process 
accounting. To do this, as root, link /etc/init.d/acct to 
/etc/rc2.d/S30acct; then reboot. 


acctcom Lists process statistics. 

acctcom -b Lists process statistics backwards 
in time, showing what just 
happened. 


acctcom -u username 


Lists statistics for processes 
executed by the user. 


acctcom -n command 


Lists statistics for all occurrences 
of the command. 


¢ Find out what Joe’s been working on all day. 


acctcom -u joe 


¢ Find out how many times someone deleted files. 


acctcom -n rm 
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Description 


Restrictions 


C shell note 


Formats 


Examples 


Allows you to define your own commands (aliases) 
using existing UNIX commands. Typing the alias 
executes the commands you include in the definition. 


Available only with the C (csh) or Korn (ksh) shells. 


The C shell format is alias term command(s). 


alias Displays the existing aliases. 


alias term Displays the command assigned 
to the alias. 


alias term='"command(s)"' 


Defines a new term for a 
command or a series of 
commands. 


e Display the alias for psf. 
alias psf 


pel=ps.-£ 


¢ Define psf as the alias for the ps -ef (status of all 
users) command sequence in the K shell. 


alias psf="ps -ef" 
¢ Define psf as the alias for the ps -ef command 
sequence in the C shell. 
alias psf ps -ef 
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apropos search man pages for keyword 


Description Displays the titles of the man pages that contain the 
keyword you specify. You can use this command to 
determine if there is a man page for any keyword or 


phrase. 
Format apropos term Displays all titles of man pages 
that contain the term. 
Example ¢ Display all man pages that include the term "talk" 
in their title. 


apropos talk 


talk (1) 
talk to another USEE ge 
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Description Invokes a calculator. Refer to the be man pages for 
details about advanced options. The default mode for 
division is integer only. 


Format be Displays a blank line to use for 
calculations. 


Examples e Start the calculator. 
be 


¢ Perform calculations. 
243 + 100 and press RETURN 


348 


25-5 and press RETURN 





24/6 and press RETURN 





12*4 and press RETURN 


e Check the current number of places past the 
decimal point. 


scale 


¢ Change the current number of places past the 
decimal point to 2. 


scale=2 
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cal display calendar 


Description Displays a calendar. 
Formats cal Displays a calendar for current 
month. 
cal year Displays a calendar for specified 
year. 


cal month year Displays a calendar for specified 
month and year. 


Restrictions You must enter the full year; if you enter 91 rather 
than 1991, a calendar for the year 91 (rather than the 
year 1991) displays. 


Examples ¢ Show a calendar for this month (October, 1990). 
cal 


~ October 1990 
S M Tu W TR EF S 


¢ Show a calendar for December of 1991. 
cal 12 1991 


December 1991 
S Mr W Th EF S 
1 2 3 4 5 6 q 
8 9 [0 LL ta 1.3 14 
PaO ee ee Sa 
22 eS Oe a Ze ee a eS 
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cancel 


Description 


Formats 


Example 


cancel print job : 


Cancels or stops a request sent to the printer. When 
you issue an lp command to print a file, lp assigns a 
request ID to the file. To stop printing your file, use 
the cancel command and the request ID associated 
with that file. 


cancel request-ID 
Cancels a specific print job. 
cancel -u username 


Cancels all jobs requested by this 
user. 


cancel printername 


Cancels the current job on this 
printer. 


¢ Cancel a job you started. First, find the request ID. 
Then, cancel the job, using the same request ID. 


lpstat 


—ps_tty06-587 : s0e «= «134. October 19 11 32 on pri 


cancel ps tty06—-587 


_ request "Ds tty06-588" cancelled 
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cal 


Description 


Formats 


Examples 
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display a file 
Displays the contents of a file. 


If a file has more than one screen of information to 
display, the screen scrolls to the end of the file. If you 
want to see one page at a time, use another display 
command (more, less, pg). 


cat filename Displays the contents of the file. 


cat Takes input from the keyboard 
instead of a file; used with 
redirection to create (>) or add to 
(>>) a file. 


¢ Display the contents of the /etc/profile file. 
cat /etc/profile 





# ident "@(#)sadmin:etc/profile 2.3" e y 
# The profile that all logins get before using their ow - 


= (screen scrolls to end) 
umask 022 


° Create a file (file3) that contains filel and file2. 
cat filel file2 > file3 


This is the text for filel Da: two files displayed 


This 18 the text for file2 , Through cat become files 


¢ Create the temp file from keyboard input; end input 
with CTRL-D. 


cat > temp 
This is a test line. <CTRL-D> 
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Description Changes the current directory. 


Formats cd Changes to your home directory. 
cd / Changes to the root directory. 
cd .. Changes to the directory above 

(the parent directory). 
ced directory Changes to the specified 
directory. 


Examples ¢ Change from any directory to Joe’s home directory. 


cd 


¢ Change from /home/joe to /home/mary. 
cd ../mary 


¢ Change from any directory to /usr/public/src. 
cd /usr/public/srce 


¢ Move up to the public directory, which is one level 
above the current directory. 


ca .. 
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chgrp change group 


Description 


Restrictions 


Formats 


Examples 
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Changes the group that a file belongs to. You can 
specify any group name listed in the group ID file 
(/etc/group). 


The group associated with the file may have special 
read, write, and execute permissions that allow 
members to access the file while preventing users 
from other groups from accessing it. 


You must be the owner of the file or root to use this 
command. 


chgrp group file Changes the group of a file. 
chgrp -R group directory 


Changes the group of a directory 
and all the files in the directory. 


¢ Give the lab group permission to use the chem file. 
chgrp lab chem 


¢ Give the lab group unlimited access to all files in the 
testing directory. 


chgrp -R lab testing 
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Description 


Restrictions 


Formats 


Changes the access mode of a file. The chmod 
command sets a file or directory’s read, write, and 
execute permissions for the owner, the group, and 
other users. 


You must be root or the owner of the file or directory 
to use this command. 


chmod user action permission file 


Change the file permissions for all 
types of users. 


chmod -R user action permission directory 


Make chmod recursive (affect the 
directory and all files and 
directories below it in the 
directory structure). 


The user, action, and permission options are listed 
together without spaces; they’re treated as one 
argument. The table on the next page lists the user, 
action, and permission options. 


You can use any combination of options as long as you 
include a user (owner, group, other, all users), an 
action (add, remove, set), a permission (read, write, 
execute), and a file or directory name. 
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chmod, cont. 


Options 


owner of the file 

group to which the owner belongs 
all other users 

all users; can be used to represent 
the combination of ugo 


add permission 


remove permission 
set privileges exactly 


Permission 

r read permission; able to read a file, 
or list a directory’s contents 

Ww write permission; able to make 
changes to a file; or delete, copy, 
and rename files within a directory 
execute permission; able to execute 
a file or access a directory 





Examples e Remove write (w) permission from the group (g) for 
the animal file. 


chmod g-w animal 


e Allow all users (a) to read (r), write (w), and execute 
(x) the office file. 


chmod atrwx office 
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Description 


Restrictions 


Formats 


Examples 


chown 





Changes the owner of a file or directory. 


Only root or the owner of a file can change the owner 
of a file or directory. 


chown owner file 

Changes the owner of the file. 
chown owner directory 

Changes the owner of a directory. 
chown -R owner directory 


Changes the owner of the 
directory, including all files and 
subdirectories. 


¢ Give Joe ownership of all the files in the product 
directory. 


chown -R joe product 


¢ Make Jane the owner of the absence log. 


chown jane absence.log 
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clear clear screen 


Description Clears your current screen. 


Format clear Clears the current screen. 
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Description 


Formats 


Example 










_ change 








Changes the screen colors. 


You can change the background and foreground colors 
on a screen by specifying either the name of a color or 
a value that represents the color. 


The color names you can use are black, blue, cyan, 
ereen, magenta, red, white, and yellow. 


Numeric values for colors are between 000 and fff; 
each position in the value represents an amount of 
red, green, and blue, respectively. Changing these 
numbers individually allows 4096 color combinations 
between the darkest, 000, and the lightest, fff. 


color -show Lists the current screen colors. 
The first two listed (cO0 and c01) 
are the current background and 
foreground colors, respectively. 


color -bc color -fc color 


Changes the background and 
foreground colors of a screen. 


e Change the background color to black and the 
foreground color (letters) to red. 


color -bc black -fc red 
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cp 


Description 


Formats 


Examples 


266 


Copies one file to another file on the hard disk. 


cp file newfile Copies the file to the new file. 
cp directory/file newdirectory 


Copies the file to the new 
directory. 


cp -r directory newdirectory 


Copies an entire directory tree to 
a new directory. The -r option 
makes ep recursive, so it finds 
and copies all subdirectories. 


¢ Make a copy of the dogs file and call the new file 
pets. 


cp dogs pets 
¢ Make a copy of the /usr/public/office directory and 


all its files and subdirectories. Call the new parent 
directory/usr/public/admin. 


cp -r /usr/public/office 
/usr/public/admin 


¢ Copy all files in the current directory to /tmp. 
cp * /tmp 
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Note 


Restrictions 


Formats 


Description 





Copies files to or from a hard disk, floppy disk, or tape. 


Before using cpio to write or copy files, use a file list 
command (Is, find) as input to cpio; this provides 
accurate pathnames to the files you want to write or 
copy. cpio creates an archive file which can only be 
restored with a cpio command. 


cpio has many options. The combinations listed here 
are fairly standard for output (-ocv -O), input 
(-imdcuv), and list (-ictv). In addition, you should 
include the -B option when writing to or restoring 
from a tape. 


To copy a file or directory to a floppy disk, you must 
use a formatted disk. The cpio command does not 
format a disk. To format a floppy disk, refer to the 
fdfmt command summary. 


file list | cpio -ocv > filename 


Writes all files listed by a file list 
command (Is, find) to the 
specified file. 


file list | cpio -ocv -O > device 


Writes all files listed by a file list 
command to the specified device, 
prompting for new disks or tapes 
as each one fills up. 
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Cplo, cont. 





cpio -imdcuv filename < device 
Retrieves only the specified file 


from the epio archive on the 
device. 


cpio -imdcuv < device 


Retrieves all files from the 
specified device. 


cpio -ictv < device 


Lists the files contained on the 
device. 


file list | cpio -pdmv directory 


Copies all files listed by the file 
list command to the directory. 
These files are not copied in cpio 
format, so they can be accessed 
using other commands. 


Examples ¢ Copy the contents of your home directory to floppy 
disks in the internal drive. 


1s /home/joe | cpio —ocv -O > 
/dev/dsk/f£d0 
e Retrieve a cpio backup from tape. 
cpio -imdcuv -B < /dev/rmt4 
NOTE: This command replaces existing 
files on your hard disk. 
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crontab 


Description Creates a file of commands you want executed by the 
cron process. cron is an automatic process that 
reads and executes files in the 
/var/spool/cron/crontabs directory. These files 
include scheduling information and commands for 
tasks that run on a regular schedule (backups, 
deletes, listings, messages). 


The entries in these files consist of six fields, each 
separated by spaces or tabs. The first five fields 
define when to execute the command in the sixth field. 
The first five fields specify the minute (0 to 59), the 
hour (0 to 23), the day of the month (1 to 31), the 
month (1 to 12), or the day of the week (0 to 6, where 
0 is Sunday). 


Restrictions You must be root and add a username after the option 
to change, remove or list any other user’s crontab file. 


Formats crontab -e Edit your crontab file, or create an 
empty file to edit if crontab 
doesn’t exist. 


crontab -| List your crontab. 
crontab -r Remove your crontab. 
Example e List Joe’s crontab file. 


crontab -l joe 





00 17 * * 1,2,3,4,5 /usr/bin/ckbupsed>/dev/console 


This crontab entry runs a check for backup 


program on the console screen (F1) every 
Monday through Friday at 5pm. 
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date set or display date and time 


Description Displays or sets the date and time. 

Restrictions Only root can set the date. However, any user can 
display it. 

Formats date Displays current date and time. 
date mmddHHMMyy 


Sets the current date; mm, dd, 
HH, MM, and yy represent the 
current month, date, hour, 
minutes, and year respectively. 
Use military hours for the time 
(00-24). 


date HHMM Change only the time. 


Examples ¢ Display the time and date. 
date 


Fri Oct. 19 13°42:13°> EDT 1990 


° Set the system clock to January 8, 1991 1PM. 
date 0108130091 


Tue dan 8 13:00:00 °EST 1991 
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cf 


Description 


Formats 


Example 


calculate free disk space 


Displays the disk space used and available for each 


mounted file system. 


df 


df -k 


Displays free disk space in blocks 
(512 bytes per block). 


Displays disk usage in kilobytes, 
including total space, space used, 
space available, and percentage 


¢ Find out how much space is left on your hard disk 


(/dev/dsk/cOd0s1 ). 


df -k 


filesystem kbytes used | 


/dev/dsk/c0d0sl1 79872 
Oroc 0 
ie | 0 
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avail capa 


ty mounted on | 
/ ne 


01190 (86S. 
0 0 /pLGe 


0 Qo fdev/td 
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du display disk usage 


Description Displays the number of blocks (512 bytes) contained 
in each file or directory. 


Formats du Displays the number of blocks for 
each directory. 


du -a Displays the number of blocks for 
each directory and file. 


du -s Displays the grand total of blocks 
used by the current directory. 


Examples e Find out how much space your current directory is 
taking up and list the size of each file. 
du -a 
12 7 sh pastory 
2 /.Xdefaults 
z /temp 
1136 


e Find out the total amount of blocks used by your 
current directory. 


du -s 


13304 usr/bin 
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Description 


Formats 


Examples 


Displays the results of a command, the value of a 
variable, or the text you typed on the terminal screen. 
You can use echo to display program status while 
debugging a command file. 


echo phrase Displays the phrase. 


echo $variable Displays the value of the shell 
environment variable. 


¢ Display the phrase "TIME TO GO" in one hour. 
sleep 3600;echo TIME TO GO 






¢ Display the pathname of your home directory. 
echo SHOME 


“frone/joe 


UNIX command reference 273 


elm start electronic mail program 


Description Invokes elm, an electronic mail program. For more 
elm information, refer to the Using electronic mail 
(elm) chapter in this manual. 


Formats elm Allows you to read, send, delete, 
and store mail messages from the 
elm mailbox screen. 


elm username Sends mail without going through 
the elm mailbox screen. 


elm -s subject username < filename 


Sends a file to another user. 


Examples e Send a message to Joe without going through the 
elm mailbox screen. 


elm joe 


Your editor opens a file for your message; elm 
sends the message when you confirm the send 
option. 


e Send the office procedures file to Joe. 
elm -s procedures joe < office.proc 


Sending mail... 
Mail sent! 
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Mailbox screen 


These options are available on the mailbox screen. 


alias 
change 


COpy 


delete 
down 
forward 


group reply 


up 

mail 
options 
print 
quit 
reply 
save 
undelete 
quick quit 
search 
help 


next 
previous 
read 


redraw 
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Key 


k 
m 
0 
p 
q 
r 
S 
u 
xX 
// 
? 


RETURN 
or SPACE 
CTRL-L 


change to alias mode 
change to another folder 
copy current or tagged 
messages to a folder 
delete a message 

move down the mail index 
forward a message to 
another user 

reply to everyone who 
received the current 
message 

move up the mail index 
mail a message 

access elm options 

print a message 

exit from elm 

answer a message 

save a message in a folder 
cancel the delete request 
quit without changing 
search for item in message 
find out more information 
about a specific command 
display the next ten 
message lines 

display previous ten 
message lines 

read a message 


redraw a screen 
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screen editor — 


Description Invokes the emaes editor, an editor used as an 
alternative to the vi editor. emacs allows you to: 


edit several files simultaneously 

open multiple windows on the same document 
define keyboard macros 

customize its commands to fit your needs 


create your own commands by using the Lisp 
programming language 


emacs is distributed under a general public license 
and is not part of the Amiga UNIX system software. 
More information is in the GNU Emacs Manual 
published by the Free Software Foundation (675 
Massachusetts Avenue, Cambridge MA 02139). 


emacs What happens? 


commands 


emacs start emacs 
CTRL-X then CTRL-C exit emacs 
CTRL-Z suspend emacs 
CTRL-X then CTRL-F file create a file 


CTRL-X then CTRL-F file read an existing file 
CTRL-X then CTRL-S save a file 

CTRL-X then CTRL-D list files 

CTRL-*% get help 

CTRL-* T start the tutorial 
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Description Displays environment variables. Environment 
variables are shell variables that are passed to 
programs like mail, elm, and vi for use in their 
processing. 


Note env is closely related to the setenv and set 
commands; read those Command Reference pages for 
more information. 


Formats env Displays the values of all 
environment variables (those 
variables used by commands 
invoked from your current shell). 


Example ¢ List your environment variables. 


env 





WUe/aene/erol 
Teor rr lc rtrs—“—s—sS—sS 
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exit log out of shell 


Description Logs you out of your current shell. 


If your current shell is the only shell, exit logs you out 
of the system. Typing exit at the shell prompt is the 
same as pressing CTRL-D. 
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fdfmt format floppy disk 


Description Formats a floppy disk in the floppy disk drive. 
Format fdfmt > device Formats a disk in the device. 
Examples ¢ Format a disk in the internal floppy disk drive. 


fdfmt > /dev/rdsk/fd0ft 


¢ Format a disk in a second internal floppy disk drive 
connected to your system. 


fdfmt > /dev/rdsk/fdlf 


¢ Format a disk in an external floppy disk drive. 
fdfmt > /dev/rdsk/fd2f 
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file show file type 


Description Determines and displays the file type (for example, 
directory, executable, commands, or English text file). 


Formats file filename Determines and displays the file 
type. 
file * Determines and displays the file 
type of each file in your current 
directory. 
Examples ¢ Find out the file type of the file named pets. 
file pets 


pets: | | English text | 


¢ Find out what types of files are in your directory. 


file * 

Cancelled mail: empty file 
Maa directory 
News: directory 
Gime selocks commands text 
trash: ascii, text 
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Description Searches a directory tree to locate a file. 


Formats find directory -name filename -print 


Find the file in the directory tree 
and display its name on the 
screen. (The -print option prints 
the name on your screen. ) 


Examples e Find and display the pathnames of all files named 
pets in the current directory and its subdirectories. 


find 





—name pets -print 






¢ Find and display the pathnames of all files whose 
names begin with "m" in the zoo directory and its 
subdirectories. 
find zoo -name "m*" —-print 
ee 


feemcs 
f/mystate 
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Description 


Formats 


Examples 


282 


Displays status information about each user currently 
logged in to your system, including: 


e username 

e full name 

e virtual screen (tty and console) 
e idle time 

e time when user logged in 


e location Gf known) 


finger Displays the status of users who 
are logged in to the system. 


finger -| Displays user status 1n more 
detail. 


finger username Displays detailed status about the 
specified user. 


finger username@system 


Displays the status of the user on 
the specified system on a network. 


e Find out who is logged in to your system. 


finger 
Login Name TAY Idie When Where 
root The Super User console 1.41 Fra ci2 36 
joe Joe Smith term/con2 fri 09. 50 
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Description 


Formats 


Example 


UNIX command reference 


program available with Amiga UNIX. Like finger 
(with a lower case "f'), this command displays 
information about each active user on the system; in 
addition, Finger supplies information about the 
processes and shells each user is running. 


Finger Displays information about active 
users and their processes and 
shells. 

Finger -| Displays additional information 


about each active user, including: 
home directory, user number, 
group number, and shell. 


Finger username Displays detailed status about the 
specified user. 


Finger username@system 


Displays the status of the user on 
the specified system. 


e¢ Find out what programs are running on each virtual 
screen in the utopia system. 


Finger 
[utopia] : 
NAME GROUP FULLNAME WHAT IDLE ITY LOCATION 
Carol doc Carol Jones ksh 41 OUS/o welcers) 
joe sales Joe Smith Reh 80 ble; 2 harhie 


robert = mkL Pope Gee CCC 
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Description 


Formats 
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le system ch 


Examines your hard disk and makes repairs if 
necessary. This process runs automatically when 
UNIX is not shut down properly and tries to enter 
multi-user mode during reboot. 


fsck (without options) asks you to confirm any disk 
repair that needs to be made. If fsck cannot 
determine a file’s name, it places the file into the 
lost+found directory in the top level of the file system 


being modified. 


WARNING: 


fsck 


fsck -m 


fsck -y 


Never use fsck on a mounted file 
system. If you need to check or 
repair your hard disk, change to 
single-user mode first. 


Examines the file system; 
prompts the user to confirm 
repairs. 


Examines but doesn’t repair the 
file system; used to verify that a 
file system is suitable for 
mounting. 


Assumes a yes answer to all 
questions and automatically 
repairs any problems. This option 
is used during reboot. 
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Example ¢ Check your external hard drive for problems. 
fsck /dev/dsk/c3d0s1 
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Description 


Format 


ftp commands 


286 


Network File Transfer Protocol 


The File Transfer Protocol (ftp) allows you to access 

another system on a connected network and perform 
several file and directory functions, including copying 
and deleting. 


After you connect to the other system (remotesystem), 
ftp asks you to login. After you log in, the ftp prompt 
({tp>) appears. You can use ftp commands to perform 
file and directory tasks. A few of the commands are 
listed below; refer to the ftp man pages for a more 
complete list. 


ftp remotesystem 


Access the remote system. 


Once you have logged in to the remote system, you can 
use the ftp commands. In the following examples, 
"local" refers to files and directories on your original 
system; remote’ refers to files and directories on the 
system with the ftp prompt. 


bye Break the session with the remote 
system. 


delete remotefile 


Delete a file on the remote 
system. 


get remotefile localfile 


Move the remote system’s file to 
your local system. 


help List the ftp commands. 
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help command _ Display a description of the 
command. 


put localfile remotefile 


Move the local file onto the remote 
system. If you do not provide a 
remote filename, put gives the 


remote file the same name as the 
local file. 


Examples e Access the abc system. 
ftp abc 


Connected to ta 





¢ Copy the library file from the abc system to your 
local system. Give the new file the same name as 
the remote filename. 


get library 


200 PORT command. successful 

150 ASCII data connection for file 162.6 201.143, 1051) (307) 
226 ASCII Transfer complete 

local iibrary remote: library 

321 bytes received in 0 017 seconds (19 Kbytes/s) 

ftpe 
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Description 


Formats 


Restrictions 


Examples 
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search files for a phrase 


Searches files for a specified word or phrase and 
displays all the lines that contain the word or phrase. 


grep phrase file(s) 


Searches the file(s) for the word or 
phrase and displays any line 
containing it. 


grep -i phrase file(s) 


Searches files for the phrase and 
ignores letter case. 


grep -n phrase file(s) 


Searches files for the phrase and 
lists the line number the phrase is 
found on. 


If the phrase has more than one word, close it in single 
quotes. 


e Search for the word "home" or "HOME" in the 
.profile file. 


grep -i home .profile 
SHOME/ olsetup #'@Do not edit this line 1@ 


¢ See if the phrase "do not" is in any file in the current 
directory. 


grep ‘do not’ * 


Lis =H Do not attempt: auto-login upon initial © 
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Description Displays the first 10 lines of a file. You can also 
specify the number of lines displayed. 


Formats head file Displays the first ten lines of a 
file. 
head -n file Displays the first n lines of the 
file. 
Examples ¢ Display the first ten lines of the office.proc file. 


head office.proc 


¢ Display the first 25 lines of the zoo file. 
head -25 zoo 
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history display previous commands 


Description Displays a list of commands you recently typed at the 
shell prompt. 
C shell note This command works in the Korn and C shells. 


However, for history to be recorded in the C shell, 
you must set the history variable to a number of lines 
(set history =n). 


Formats history Displays previously executed 
commands; history is the last 
command displayed. 


history -r Displays previously executed 
commands in reverse order; 
history -r is the first command in 
the list. 


Examples e List the commands you most recently typed during 
this session. 
history 


477 finger 
478 finger joe@utopia 
479 Finger @utopia 


x 


492 history 


¢ Find out whether you ordered a printout of a specific 
file by looking for the lp command in the command 
history. 


history | grep lp 


481 lp =o postscript test 
496 history | grep lp 
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Description Controls processes for etal screens, seta a init 
levels from information stored in the /etc/inittab file. 


init scans and executes commands specified in 


/etc/inittab. 
Restrictions You must be root to execute the init command. 
Format init runlevel Reads /etc/inittab and executes 


any commands associated with 
the run level. 


shuts down the system safely 
system administrator mode 
multi-user mode 

remote file sharing mode 
single-user mode 

reboot 


Run levels 





Examples ¢ Reboot the system. 
init 6 


INT] New run level 4 
system coming down . Please wait | 
System services are now ‘being stopped 





(The system reboots and displays a logi : p ompt) : 


¢ Shutdown the system. 


init 0 










INIT New run leve. 

System coming down — 
System services are 
the eye cen 1s COwn 


lease wait 
a stopped 





(Turn the machine Of ren on, to reboot) 
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list background jobs 





Description Lists your background processes (jobs). 
Restrictions This command works only in the C and Korn shells. 
Formats jobs Displays your background 
processes. 
jobs -| Displays your background jobs in 


a long format. 


Examples ¢ Find out what background jobs are running at the 


present moment. 
jobs 





AU eee 8 


e List all your background jobs and their PIDs. 
jobs -l 


[1] + 177 Running sleep 100 & 
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Description Terminates a process. 


Restrictions You must log in as root or own the process to kill it. 


Formats kill PID Kills the process specified by the 
PID. 


kill % jobnumber Kills the process specified by the 
job number. 


Examples ¢ Stop a background process called sleep. First, find 


the PID for sleep, and then kill the process using 
the PID. 


Pps 





kill 177 





¢ Stop a background job. First, list the jobs, and then 
kill the sleep 100 & job. 


jobs 





kill %1 
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Description 


Format 


Movement keys 


Example 
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display a file 


Displays the contents of a file. 


less filename Displays the contents of a file. 


Once the file is displayed, 


use the following keys to 


move backward and forward through a file. 


Keys 


SPACEBAR move forward one screen 
RETURN move forward one line 
move back one screen 


help 
quit and return to the shell prompt 
/term search for term 
lcommand invoke a shell command 





¢ Display the /etc/inittab file. 


less /etc/inittab 
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In link files or directories 
Description Creates either a hard or symbolic link. 


A hard link creates a name that points to another file; 
it cannot point to directories or across file systems. 


A symbolic link creates a name that points to the 
original directory or file; it can point across file 
Systems. 


A link allows a single file or directory with two (or 
more) names. 


Formats In file newfile Hard links a file to a new 
filename. 


In -s directory newdirectory 


Symbolically links a directory to a 
new name. 


Examples e Create a jobs file that points to the tools file. 


ln tools jobs 
¢ Create and symbolically link the /usr/games 


directory with Joe’s home directory. List the new 
directory. 


ln -s /usr/games /home/joe/games 
11 /home/ joe 
total 2 


Corse eee 2 carol obher 32. Oct 4 10-07 Mail 
“rw-r--r--l1 carol other 17 Oct 18 14 51 games->/usr/games 
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Ip print files 


Description Prints a file or several files. Unless you specify a 
particular printer, lp uses the default printer. 


Formats Ip file Prints the file. 
Ip file file Prints multiple files. 
lp < file Prints a file which does not have 
read permission set for other 
users. 
lp -n n file Prints n copies of the file. 


lp -d printer file Prints the file on the specified 
printer. 


lp -o options file Prints the file using options for 
your printer interface. 


Examples e Print the pets file. 
lp pets 


¢ Print the PostScript test file on your PostScript 
printer. 


lp -o postscript test.file 
Fegquest 146-18 post2-1¥2"(1 file) 


¢ Print the sales file on the printer named billing, 
without a banner page. 


lp -d billing -o nobanner sales.file 


request id is post2-17. (1 file) 
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Description 


Note 


Restrictions 


Formats 


This command performs several print service 
functions: 

e defines printers and devices 

e adds, changes, and removes printers 

e sets or changes the system defaults 


e defines user alerts for printer defaults 


There are many configuration options with the 
Ipadmin command. However, only four options are 
mandatory to define a printer connected to your 
Amiga: default (-d), printer name (-p), device (-v), and 
interface (-1). 


To setup printing, you need to use the enable and 
accept commands. See the Printing chapter for 
instructions. 


You must be root to use this command. 


Ipadmin -p name -v device -i interface 


Defines a printer (name) for your 
system. 


lpadmin -d name 


Defines the default printer. 
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lpadmin, cont. 


Examples e Define a printer named pl as a PostScript printer on 
the main serial port. 


lpadmin -p pl -v /dev/term/ser —i 
/usr/spool/lp/model/postscript 


¢ Define a PostScript printer on the parallel port. 


lpadmin -p p2 -v /dev/par -i 
/usr/spool/1lp/model/postscript 


¢ Make pl the default printer. 
lpadmin -d pl 
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report printer status _ 


Description Displays the status of any requests sent to the printer 
and the status of the printer. You can use the request 
ID displayed by the lpstat command with the cancel 
command to stop printing. 


Formats Ipstat Displays the status of requests 
you sent to the printer. 


Ipstat -d Identifies the default printer. 
lpstat -p printername 


Lists requests sent to the 
specified printer. 


Ipstat -u username 


Lists requests sent to the printer 
by the user. 


Ipstat -o Displays the printer status and 
all print requests. 


Ipstat -v Displays the device names for the 
printers on your system. 


Example ¢ Check the status of all print requests. 
lpstat -o 
posta 17. carol . So Get 20 15 01 
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Description 


Formats 


Options 


300 


list file and directory information | 


Lists information about the files and subdirectories 
contained in a directory. 


Is -option Lists the files contained in your 
current directory. The format of 
the list changes with the options. 
Without an option, Is displays an 


alphabetical list. 

ll Predefined shortcut for Is -] dong 
format list). 

If Predefined shortcut for Is -F 


(displays special characters 
indicating directories (/) and 
executable programs (*)). 


display all files, including files that 
begin with a period 
display special characters to indicate 


directories and executable programs 
long format 

reverse the sort order 

display files by time stamp (latest 
first) 
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Examples e List the contents of Joe’s home directory in the long 
format. 





e List your files by the time they were last modified, 
ending with the files you most recently changed 
(reverse time order). 


ls -rtl 





e Find out if .profile is in your home directory. (You're 
currently working in your home directory.) List all 
filenames, including those starting with a period. 


ls -a 
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Description 


Formats 


Options 


Examples 


302 


read and send electronic mail 


Invokes an electronic mail program. This program 
provides some of the same functions as elm, another 
electronic mail program, except mail doesn’t display 
a list of messages or a menu of options. 


mail Displays mail sent to you by other 
users. 

mail user Sends mail to a user. End the 
message with a period on a blank 
line. 


mail user@system 


Sends mail to a user at the 
specified system. 


help 
display next message 


delete message 

print message 

quit 

reply to message 

save message in your mailbox 





¢ When you log in to your system, a notice tells you 
that you have mail. Read your mail messages. 


mail 
e Send a mail message to Joe. 


mail joe 
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Description 


Note 


Format 


Example 


DESCRIPTION 2 


Displays the on-line manual pages for a specified 
command. 


Some commands have more than one set of man 
pages. For example, echo has a page for 
AT&T/Amiga UNIX, a page for Berkeley UNIX, and a 
page for a different FMLIU (Form and Menu 
Language Interpreter Utilities) command. All three 
man pages are displayed in sequence; the first one is 
probably the most useful. 


man command _ Displays the man page for the 
specified command. 


¢ Find out about options that are available with the 
lpstat command. 


man Bi teckel 


oe ay a ee i USER XCOMMANDS . oe 


oa 


Aestae = ‘print information. about che status. ce the LP 
ee service 9. 










aoeea 


the lpstat comnend ee iyiortetacn about the. current 
: (Status Of the LP pe service 8 


ae no options are given, then Ipstat prints” the status 
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mesg allow or deny messages 


Description Allows you to decide whether your screen can be 
interrupted by messages from other users. 


Formats mesg Displays your message receiving 
status (y/n). 


mesg y Allows your terminal to receive 
messages. (This is the status 
when you log in.) 


mesg n Prevents your terminal from 
receiving messages. 


Examples ¢ Find out if you can receive messages. 


mesg 
is y 


¢ You don’t want to be interrupted by messages from 
other users. 


mesg n 
e You want to accept messages. 


mesg y 
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Description 


Formats 


Examples 


Creates a directory. 


mkdir directory Creates a directory. 
mkdir directory directory 


Creates several directories ata 
time. 


mkdir -p directory 


Creates a directory and all the 
directories necessary to complete 
the path. 


¢ Create a directory named projectx. 
mkdir projyectx 

¢ Create three new directories. 
mkdir procs bills accounts 


¢ Create a zoo directory with a pets subdirectory. 
mkdir -p zoo/pets 
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mkfs make file system 


Description Creates an empty file system on a hard disk partition, 
floppy disk, or tape. The file system can be mounted 
once you create it with mkfs. 


When you use the mkfs command, specify a device 
and the size of the file system (in file system blocks). 


Note The mkfs command waits 10 seconds before starting. 
During this time, you can abort mkfs by pressing the 
DEL key or CTRL-C. 


Format mkfs -F FStype device blocks 


Creates a file system (FS) on the 
device with the specified number 
of blocks. 


A hard disk uses /dev/dsk/cxdOsy as the device format 
(x is the SCSI device number and y is the partition 
number). You can change the numbers x and y to 
identify the specific SCSI device and partition for each 
file system (do not use 0 for y because 0 identifies the 
entire hard disk, not a partition). 


The floppy disk drive uses /dev/dsk/fdn as the device 
format (n is the number of the drive). The standard 
internal floppy disk is /dev/dsk/fd0O and has 1760 
blocks. 
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¢ Make a System V file system with a block size of 
76800 (35 Mb) on hard disk /dev/dsk/cld0s1 (SCSI 
disk 1). 


mkfs -F s5 /dev/dsk/cl1d0sl1 76800 


Examples 


e Make a System V file system with a block size of 
1760 on the floppy disk in the internal drive (0). 


mkfs -F s5 /dev/dsk/fd0 1760 


UNIX command reference 307 





Description 


Formats 


Movement keys 


Examples 


308 


display file contents 


Displays the contents of a file or several files, one 
screen at a time. 


more file Displays the contents of a file. 


more file file Displays the contents of a file 
followed by the contents of 
another file. 


Once the file is displayed, use the following keys to 
move backward and forward through a file. 


Key's 


SPACEBAR move forward one screen 
RETURN move forward one line 


b move back one screen 

q quit and return to the shell prompt 
/term search for term 

lcommand invoke a shell command 

¢ help 





¢ Display the pets file, then display the dogs file. 


more pets dogs 


e Display a yearly calendar, one screen at a time. 


cal 1991 | more 
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mount 


Description 


Restrictions 


Formats 





Mounts file systems. A file system must already exist 
on the device before you can mount it. 


When you use the mount command, you specify a 
device and a directory. The directory is the mount 
point you use to access the mounted file system. 


You must be root to mount a file system. 


Don’t mount a file system to a directory that has data 
init. You won't be able to access the original contents 
of that directory until you unmount (umount) the 
new file system. 


mount Displays information about file 
systems already mounted. 


mount directory Checks the /etc/vfstab file and 
mounts the file system listed for 
the specified directory. 


mount -F FStype device directory 


Mounts the file system (FS) from 
the device to the directory on the 
hard disk. 


A hard disk uses /dev/dsk/cxdOsy as the device format 
(x is the SCSI device number and y is the partition 
number). You can change the numbers x and y to 
identify the specific SCSI device and partition for each 
file system (do not use 0 for y because 0 identifies the 
entire hard disk, not a partition). 
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mount, cont. 





The floppy disk drive uses /dev/dsk/fdn as the device 
name (n is the number of the drive). 


Example ¢ Mount the System V file system on /dev/dsk/c1d0s1 
at directory /mnt/joe. 


mount -F s5 /dev/dsk/cl1ld0sl1 /mnt/joe 
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Description 


Formats 


Examples 





Moves a file to another directory or renames a file. 


After a move or rename operation is completed, the 
source file or directory no longer exists. 


mv file newfile |Renames the current file with the 
new filename. 


mv directory newdirectory 


Renames the current directory 
with the new directory name. 


mv file newdirectory 


Moves a file to a new directory. 
The file retains its original name. 


¢ Change the name of the dogs file to pets. 
mv dogs pets 
¢ Rename the directory /home/joe to /home/nina. 
mv /home/joe /home/nina 
¢ Move the report file into the /home/nina directory, 
keeping the original name. 
mv report /home/nina 
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oladduser 





Description 


C shell note 


Format 


Example 
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set up OPEN LOOK defaults — 


Creates your OPEN LOOK environment so you can use 
OPEN LOOK’s files and default values. This command 
puts various OPEN LOOK and X Window System 
resource files in your home directory and modifies 
your .profile. 


oladduser copies the following files from /usr/X/adm 
into your home directory: 

e .Xdefaults 

e .olinitre 

e .olprograms 
Copies the file .olsetup and adds this line to the 
.profile file: 

e .$HOME/olsetup # do not change line! 
For C shell users, oladduser adds the following lines 
to the .login file: 

e setenv DISPLAY unix:0 

e setenv XNETACCES on 

° set path=( $path /usr/X/bin ) 


/usr/X/adm/oladduser username 


Sets up an OPEN LOOK 
environment. 


¢ Set up an OPEN LOOK environment for Joe. 
/usr/X/adm/oladduser joe 
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Description Starts OPEN LOOK, a graphical user interface based 
on the X Window System, from which you can run 
terminal windows and programs. 


Formats olinit Starts OPEN LOOK on your 
system. 
olinit -- be Starts OPEN LOOK with the 


backward compatibility option of 
X. Use this format if you want to 
use an application that was 

written for previous versions of X. 


olinit -- argument 


Passes the argument to the X 
server; can be any valid X Window 
System argument. 


Example ¢ Run an application written for version 3 of X. 
olinit -- be 
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passwd set or change password 


Description Sets or changes login passwords. 


This command prompts you for your old password, 
and then prompts you twice for your new password. 


Restrictions If you are logged in as root, you can create and change 
any user’s password by adding the username after the 
command. 


A password must be at least six characters long and 
must contain at least two alphabetic characters and at 
least one numeric or special character. For example, 
test, testl, and 123456 are not valid passwords; 
testing] is. 


Format passwd Allows you to add or change your 
password. 
Examples ¢ Change your password from billing] to sales1. 
passwd 
passwd: Changing password for joe 


Old password: <billingl> 
New password: <salesl> 
Re-enter new password: <salesl> 


Type the old password (billing1 ), and then type 
the new password (salesl). Verify the new 
password by typing it again. 

° As root, change Joe’s password. 
passwd joe 


Type the new password, then confirm it by 
typing it again. (root does not have to enter the 
old password.) 
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passwdall 


Description 


Restrictions 


Note 


Formats 


Examples 


set or delete system passwords 


Sets or deletes passwords for all system accounts. 
You must be root to use this command. 


This command is specific to Amiga UNIX. 


passwdall Allows you to enter a standard 
password for all the system 
accounts. 


passwdall -d Removes passwords from all 
system accounts. 


e Assign billing] as the password for all your system 
accounts. 


passwdall 


New password <billingi> 
Re-enter new password <billingl> 


Enter the new password (billing1 ), and then 
verify the password by typing it again. 


e Remove passwords from all system accounts. 
passwdall -d 
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page through a file - 


Description Displays the contents of a file or several files, one page 
at a time. 

Formats pg file Displays the contents of a file. 
pg file file Displays the contents of multiple 


files, one after the other. 


Movement keys Use the keys in the chart below to move through the 
file. 


Keys 


RETURN move forward one screen 

- (hyphen) move back one screen 
move forward n screens 
move back n screens 


move forward n lines 

move back n lines 

search for term 

reverse search for term 

display help 

quit and return to the shell prompt 





Example e Display the office file, one screen at a time. 
pg office 
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check remote system status. 


Description Determine if a system is operational on your network. 
If the system is active, ping displays "system is alive". 
If after 20 seconds the system does not respond, ping 
displays "no answer from system". 


Formats ping system Determines whether a system is 
currently active on your network. 
The system is a system name from 
your /etc/hosts file. 


ping address Determines whether the system 
at the specified internet address 
is active. 


Examples ¢ Find out if the system called elvis is working. 
ping elvis 
elvis is elie: 


e Find out if the system with internet address 
192.9.205.41 is working. 


ping 192.9.205.41 


192.9 205 41 18 alive | 
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pr 


Description 


Formats 


Examples 
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format a file for printing 


Formats a file in a standard page size and displays it 
on the screen. You can adjust the page size, header, 
columns, and line spacing with pr options. pr is 
frequently used to format a file before sending it to be 
printed (Ip). 


The standard page size is 66 lines (including 10 lines 
of header and trailer output) by 72 columns. 


pr file Paginates and displays the file. 


pr -n file Paginates the file and numbers 
the lines on each page. 


¢ Paginate and view the sales file. 


pr sales.file | more 


¢ Paginate and print the payroll.c program with 
numbers on each line. 


pr -n payroll.c | lp 
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list processes 





Description Displays a list of active processes. Active processes 
include those that are running, sleeping, waiting, or 
frozen. The ps command is useful when you want to 
terminate a process and you need to find out the 
process ID (PID) number. 


Formats ps Lists active processes on the 
current terminal. 
ps -e Lists every active process on your 
system. 
ps -a Lists some important processes 


on your system. This list doesn’t 
include process group leaders 
(shells, OPEN LOOK) and 
processes not associated with a 
terminal. 


ps -u user Lists all active processes 
associated with the user. 


ps -f List processes in the long format. 
Example e List all the active processes on your system, using 
the long format. 
ps —-ef 

UID... PED »RPID 2 ..0..< SUIME. . TTY TIME COMD 
root 0 0 O° Oct 20 9 0.01 sched 
joe 1 Q 0 Oct 20 ? L-lbo Ysbain/init 
root 3 0 0 Oct. 20... 0°00. pageout 
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DWCONnV update the hidden password file 


Description 


Restrictions 


Format 


Example 


320 


Takes user information from the /etc/passwd file and 
creates a corresponding password line in the 
/etc/shadow file. 


After you update the /etc/passwd file, typing pwconv 
"hides" password information (username, password, 
password aging information) in the /etc/shadow file; 
information on a user’s password can no longer be 
found in the /etc/passwd file. After running pweonv, 
all passwords turn into x’s in the /etc/passwd file. 


You must be root to use this command. 


pwconv Takes user information from 
/etc/passwd and adds a 
corresponding line to 
/etc/shadow. 


¢ Convert the /etc/passwd from a previous version of 
UNIX to System 5 release 4. 


pwconv 
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pwd 


__ print working directory 


Description Displays the full pathname of your current directory. 


Format pwd Displays the pathname of your 
current working directory. 


Example ¢ Check your current working directory. 
pwd 


/home/ joe 
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rcp 
Description 


Restrictions 


Note 


Formats 


Example 
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remote copy 


Copies files or directories between different systems 
on a network. 


You must have a .rhosts file in your home directory on 
the remote system. The .rhosts file should include the 
name of the local system where you are issuing the 
rep command. 


If you do not specify the new filename, rep uses the 
original filename. If you do not specify the 
destination directory, rep uses the user’s home 
directory. 


rcp system:file newfile 


Copies a file from a directory on 
another system into your current 
directory with the new filename. 


rcp file system:newfile 


Copies a file from your system to 
the specified directory and 
filename on the other system. 


rep -r directory system:directory 


Copies the directory on your 
system to the specified directory 
on the other system. 


¢ Copy /home/joe/birds from the crunch system to 
your system, and change the file name to zoo. 


rcp crunch:/home/joe/birds zoo 
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Formats 


Options 


Description 








Performs three disk partitioning tasks: 
¢ creates a basic partition table 


e displays information about current partitions 


e adds custom formatting features to a hard disk 
partition 


rdb -options device partitions 


Add formatting features to the 
specified partitions in the device. 


rdb -options device 


Display information about or set 
formatting features for partitions 
on the device. 


Use the following options with rdb. 








create a new rdb table 
set sectors per track to n 

display information about the current 
partitions in a long format 

select partition n 

make the selected partition non- 
bootable 

make the selected partition bootable 
set the number of custom boot blocks 
on the selected partition to n 

set the file system type on the selected 
partition to n 

set the boot priority on the selected 
partition ton 
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‘db, cont. 


Examples 


324 





¢ Create an rdb on SCSI disk 0 with 70 sectors per 
track and three partitions. Each partition is given 
a name, a starting position, and a size (in 512 byte 
blocks). Note that the starting position of the next 
partition is the sum of the starting point and size of 
the previous partition (140 + 178710 = 178850). 


rdb -s 70 -c /dev/dsk/c0Od0sO Root 140 


178710 Swap 178850 18900 Boot 197750 7280 


¢ Display information about current partitions on 
SCSI disk 0, including name, starting point, length, 
and size. 


rdb -H /dev/dsk/c0d0s0 


Name Start Length Size 
Ll: Unix Root 2. 80224 88 meg 
2: Unix Swap 180352 20480 10 meg 
3: Unix Boot 200832 4096 2 meg 


¢ Make partition 3, on SCSI disk 0, a bootable 
partition with boot priority 2. 


rdb -p 3 -B -P2 /dev/dsk/c0d0s0 
¢ Make partition 3 bootable with 2 custom boot blocks 


and set its file system type to DOS\O for use with 
AmigaDOS. 
rdb -p 3 -B -C 2 -F 0x444£5300 
/dev/dsk/c0d0s0 


¢ Make partition 1 non-bootable and set its file 
system type to UNI\O (0x554e4900 is hex code for 
UNIN\O) for use with Amiga UNIX. 


rdb -p 1 —b —-F 0x554e4900 /dev/dsk/c0d0s0 
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Description 


Note 


Format 


Examples 


remote login - 


Logs in to another system from your system. If your 
username is in the remote system’s /etc/passwd file 
and you have a proper .rhosts file on that system, you 
can log in to the remote system without entering your 
username and password. 


You disconnect from the remote system with the exit 
command or by pressing CTRL-D. 


rlogin system Logs you in to another system 
from your system. 


¢ Log in to the crunch system without leaving your 
desk. You have a user account but no .rhosts file on 
crunch. 


rlogin crunch 
e Log in to the elvis system. Your home directory on 


elvis has a .rhosts file with the name of your current 
System in it. 


rlogin elvis 


_ UNIX ay Release — AT&T ae : 





1987, (1988 ATED 





hast login Sun Se 17 19° o6 freon narnia. | 
system Vv Release 4.0 © Amiga Version Release i. 
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remove - 


Description Removes files and directories. 
Formats rm file Deletes a file from your current 
directory. 
rm file file Deletes multiple files from your 


current directory. 


rm -ir directory Deletes a directory and all the 
files init. The -i option asks you 
to confirm whether or not each file 
is to be deleted. Answer y (yes) to 
remove the file. If you decide to 
keep any of the files, you cannot 
delete the directory. 


e Remove the pets file. 
rm pets 
Examples ¢ Delete some of the files in the current directory, but 
not all of them. 

rm -1i * 
rm remove /home/joe/junk (y/n)? y 
rm remove /home/joe/memos (y/n) ?n 
rm remove /home/joe/sales (y/n)°y | 


rm remove /home/joe/sched (y/n)?n | 
im remove /home/joe/zoo. (y/n) 7y : 
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Description 


Restrictions 


Formats 


Examples 


remove directory 


Removes empty directories. 


The directory must be empty before you can use 
rmdir. Ifthe directory has files, use the rm -ir 
command instead. 


rmdir directory Deletes a directory. 


¢ Delete the pets directory from your current 
directory. 


rmdir pets 
¢ Delete the bird and fish directories from your 
current directory. 


rmdir bird fish 


¢ Delete the /home/joe directory. 


rmdir /home/joe 
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read news | 


Description Reads messages distributed by the Usenet news 
system. 


The news system operates at three levels: newsgroup 
selection, article selection, and page selection. Each 
level has its own commands and help menu. 


Formats rm Access the news system. 


rn -c Check for unread news messages 
without starting the news system. 


Key's 


read the next message 
list articles in the news group 


help 

list subscribed news groups 

save the article in a news directory 
quit rn 

unsubscribe from a news group 





Example e Start the news system. 


rn 
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who a : : a oe | 





Description Displays a list of all users on all systems that 
broadcast rwhod status messages on your network. 
Systems broadcasting rwhod status messages in the 
past five minutes appear on an rwho list; systems 
that don’t have the rwhod daemon running won’t 
appear on the rwho list. If a user has not typed 
anything for a minute or more, rwho reports the user 
as being idle. 


Restrictions You cannot use rwho until you start the rwhod 
daemon by removing the comment sign (#) from the 
/etc/rc2.d/S72rwhod file. 


rwhod uses a lot of resources, so your network 
response time will be slow if you choose to use this 
program. 


Formats rwho Displays the status of active users 
on all systems that use rwhod on 
your network. 


rwho -a Reports on all users, even if they 
have been inactive for more than 
an hour. 


Example ¢ Check the list of active users. 


rwho -a 


UNIX command reference 329 


spreadsheet calculator 





Description Invokes a spreadsheet program. You can use this 
program to create spreadsheets similar to those 
created using PC spreadsheet software. 


Functions 


get help 
enter data 


enter a formula 


enter text 


edit data 


edit text 


delete data/text 
save to a file 
quit 


Format sc 
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press ? 

move to a cell, then press = followed 
by the numeric data 

move to a cell, then press = followed 
by the coordinates of each cell you 
want included in the formula 
(separated by the appropriate 
arithmetic signs) 

move to a cell, then press < followed 
by the text (to left justify the text), or 
press > or" followed by the text (to 
right justify the text) 

move to a cell, press e, then edit the 
data 

move to a cell, press E, then edit the 
text 

move to a cell and press x 

press SHIFT-P 

press q 





Start the spreadsheet program. 


UNIX command reference 





Description 


Restrictions 


Formats 





edit a file or stream from a command line : 


Invokes the stream editor, which allows you to 
perform edits on an entire file or pipe through a single 
command line. 


The output from sed displays the edited file, but the 
actual file is not updated. You have to use the 
redirection (>) command to save changes to a new file. 


If you include spaces in a command or between a 
range and a command, surround the range and 
command with quotes. Use quotes also for multiple 
line commands (a, 1, c). 


sed command file 


Performs the editing command on 
the entire file. 


sed rangecommand file or 
sed range command file 


Performs the editing command on 
a range of lines. The range format 
can be: 


e /term/ for all lines including 
the term 


e linenumber for a specific line 
¢ linenumber,linenumber for a 
range of lines. 


You can perform most of the same editing functions as 
vi; the chart on the following page lists some of the 
sed editing commands. 
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sed, cont. 


append the term 

insert the term 

change the phrase 
s/term1/term2/_ | substitute term1 with term2 
d delete 





Follow the a, i, and ec commands with a backslash and 
press RETURN. Except for the last line, follow each 
line of new text with a backslash, then put the 
filename on the last line. 


Examples e Substitute Monday with Tuesday in the meeting 
file. 


sed s/Monday/Tuesday/ meeting 


¢ Delete the fifth line of the office procedures file. 
sed 5d office.proc 
¢ Delete all lines that include the term "nocturnal" 
from the zoo file. 
sed ’/nocturnal/ d’ zoo 
¢ Change line 4 of the snacks file to "potato chips’. 
sed '4 c\ 
>potato chips’ snacks 
¢ Search filel and replace every occurrence of 
"projected" with "final". Redirect the output to file2 


(a new file), then rename file2 as filel so that filel is 
updated. 


sed s/projected/final/g filel > file2; 
mv file2 filel 
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Description 


Note 


C shell notes 





Displays and sets shell variables. To make changes 
available to other programs called from your shell, use 
the export command. 


Shell variables are terms you can use in command 
lines to symbolize information. The start-up file 
(.profile) loads the values of the variables when you 
log in to the system. To make changes permanent, 
edit .profile. 


When you use a shell variable in a command, type a$ 
before it and type the variable in upper-case letters 
(for example, $HOME). 


set is similar to the env and setenv commands; read 
those Command Reference pages for more 
information. 


The C shell allows you to change shell variables with 
the set variable=value command; type the variables 
in lowercase letters. To change environment 
variables, use setenv instead of set. To make the 
changes permanent, edit the C shell startup file 
(profile). 
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Formats set Displays the values of all shell 
variables. 


variable=value Changes the value of the variable. 


export variable Changes the value of the variable 
for other shell programs as well as 
the shell itself. Type this 
command at the end of the 
assignment command line or ona 
line of its own. 


Command cs 


differences 


between shells display shell 
variables 


change shell | variable=value set variable=value 
variables 


display env, printenv | env, printenv 
environment or setenv 
variables 


change variable=value; setenv variable value 
environment | export variable 
variables 
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set, cont. 


Examples e Display the shell variables. 
set 
¢ Change the value of the EDITOR variable to emacs 
in the K shell and make the change available to all 
programs. 
EDITOR=emacs; export EDITOR 
¢ Change the value of the EDITOR variable to emacs 
in the C shell and make the change available to all 
programs. 
setenv editor=emacs 
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setenv 





Description 


Note 


Shell restrictions 


Formats 


Example 


336 


_ display or set shell variables — 


Displays, sets, and automatically exports 
environment variables. Environment variables are 
shell variables that are passed to programs like mail, 
elm, and vi for use in their processing. 


Refer to the Special notes on shells section of this 
chapter for more information about shells. 


This command is similar to the env and set 
commands; read those Command Reference pages for 
more information. 


This command works only in the C shell. 


setenv Displays the values of variables. 
setenv variable=value 


Changes the values of variables in 
the C shell and in all programs 
called by the shell. 


¢ Change the value of the EDITOR variable to emacs 
in the C shell and make the change available to all 
programs. 


setenv EDITOR=emacs 
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Description Shuts down the system; this command also allows you 
to delay the shutdown and change to any init state. 


Restrictions You must be root and must be in the root directory (/) 
to shut down the system. 


Format shutdown -y -g n -1 inttstate 


Sends a message and shuts down 
the system so you can turn off the 
power to the computer safely. The 
-y option answers ‘yes’ to all 
shutdown questions. The -g 
option indicates the grace period 
before shutdown (in n seconds). 
The -i option specifies which init 
state to put the system in next. 
(The default init state is single- 
user mode). 


Examples e Shutdown the system after 900 seconds (15 
minutes), then reboot (init state 6). 


shutdown -y -g 900 -1i 6 


¢ Shutdown the system completely so you can turn 
the power off. 


shutdown -y -1 0 
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SsiIOC screen I/O control 


Description Performs device-specific control functions. sioc is 
commonly used to change the characteristics of your 
screen display, including font size, window size, 
resolution. For more information on changing these 
characteristics, refer to the Special features of Amiga 
UNIX chapter. 


Formats sioc setfont Resets the default font on your 
display. 


sioc setfont fontfile 


Changes the font on your display 
to the one specified by fontfile. 


sioc setdeffont fontfile 


Changes the system default font 
on your display to the one 
specified by fontfile. 


sioc winsize Displays the number of lines and 
columns on your display. 


sioc setkmap kmapfile 


Changes the keyboard map for 
the current terminal. 


sioc setdefkmap kmapfile 


Changes the system default for 
the keyboard map. 


The font and keyboard map files are in the 
/usr/amiga/lib/font and /usr/amiga/lib/kmap 
directories respectively. 
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SIOC, COKE 


Examples ¢ Change your font for the current virtual screen 
session to topazl1l. 


sioc setfont /usr/amiga/lib/font/topaz11l 


¢ Change the default value for your keyboard map to 
usa2. 


Sioc setdefkmap /usr/amiga/1ib/kmap/usa2 
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suspend the shell — 


Description Suspends the shell for a specified number of seconds. 
Usually, the sleep command is used in conjunction 
with another command. 


Format sleep x Pause for x seconds. 


Examples ¢ Display a list of the current directory’s contents in 
15 seconds. 


sleep 15; ll 


se 2 joe mgt 32” 
rwx 1 joe mgt 10 0c 
drwxr-xr-x 2 joe mgt 32 Oct 18 memos 
-rwor--ree 1 joe moat 17 Oct 20 14:30 meetingl 









e Start a loop program that displays the message "I’m 
waiting” every 25 seconds and put the process in the 
background. 


while sleep 25; do echo "I’m waiting"; 
done & 


[1] a - 
(affer 25 seconds ) — 
i'm waiting _ - | 
: : (after another 25seconds ) 
I'm waiting |  - 
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sort lines of files | 


Description Sorts the lines of a file (or files) in alphabetical order. 
Blanks, special characters, numbers, and uppercase 
letters are listed first unless you change the sort 
options. 


Formats sort file Sorts a file alphabetically and 
displays the results on the screen. 


sort -o newfile file 


Sorts a file and puts the results in 
a file. The -o option puts the 
results of the sort into a file. The 
new file can have the same name 
as the file being sorted. 


sort -f -o newfile file 


Sorts a file, ignores 
capitalization, and puts the 
results in a file. The -f option tells 
sort to merge upper and lower 
case letters. 


Examples e Sort the bird and fish files, and place the results in 
a file named zoo. 


sort -—-o zoo bird fish 


¢ Sort the lab file, ignore capitalization, and call the 
file by the same name. 


sort -f -o lab lab 
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sity set terminal options 


Description Sets or displays input/output options for your 
terminal. 
Formats stty Causes some options set for your 


terminal to be displayed. 


stty -a Causes all terminal option 
settings to be displayed. 


stty keyterm key Changes the setting for a 
command key sequence. 


Restrictions Don’t try to use the same key sequence for more than 
one operation (for example, if the BACKSPACE key is 
assigned as the erase key, don’t try to assign it as the 
interrupt key also). 


Examples ¢ Look at all your terminal options, including baud 
rate, command key settings, etc. 
stty -a 
speed 38400 baud; 
rows 25; columns = 80; ypixels = 200, xpixels = 640, 


inke.= “Cy: quil =. 7 |, erase = “h, Kill = (uy 
eof = “d, eol = <undeft>, eolz2 = <undet>, 


< 


¢ Change the interrupt command key to CTRL-V. 
stty intr CTRL-V 


¢ Change the erase key from the BACKSPACE key to 
the DEL key. 


stty erase DEL 
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tall display the end of a file 


Description Displays the last 10 lines of a file. You can also specify 


| the number of lines to display. 


Formats tail file Displays the last ten lines of a file. 
tail -n file Displays the last n lines of a file. 
tail +n file Displays the file starting at the 

nth line. 

Examples ¢ Display the last 10 lines of the test file. 

tail test 


¢ Display the last thirty lines of the sample file. 
tail -30 sample 


¢ Display the sample file starting at the fifteenth line. 
tail +15 sample 
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Description 


Restrictions 


Formats 


Examples 


344 


exchange screen messages 


Allows users to "talk" with one another on their 
terminal screens. Either you or the other user can 
terminate the talk program by pressing CTRL- C. 


The user you want to "talk" to must be logged in to the 
system, must have mesg set to yes, and must reply 
via the talk program. 


talk username Exchanges screen messages with 
a user on the same system. 


talk username@system 


Exchanges screen messages with 
a user on a different system. 


e Jane wants to "talk" to Joe; they are both on the 
same system. 


talk joe 


[Waiting for your party to respond] 


i in i i ee ee eet 


e Joe receives Jane’s request to talk and ena 


Message from Talk ‘Dasmondut coe at 9 56. 
talk connection requested by ietlen a) 
talk respond with talk jane@utopia ~ 


talk jane 


UNIX command reference 














Description 


floppy disk, or a tape. tar can also list files stored in 
tar format. 


Restrictions To copy a file or directory to a floppy disk, you must 
use a formatted disk. The tar command does not 
format the disk. To format a floppy disk, refer to the 
fdfmt command summary. 


tar doesn’t copy empty directories or special files. 


If you don’t list a file or directory in the command, tar 
extracts or lists everything on the device. 


Formats tar -cuf backupdevice file(s) 


Copies (ce) files or directories to 
the device. v is the option for 
verbose message and f is the 
option for file format. 


tar -xuf backupdevice file(s) 


Extracts (x) files or directories 
from the device. 


tar -tuf backupdevice file(s) 


Creates a table list (t) of the 
contents of the device. 
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Examples e List all the files and directories on a tape in an 
external tape drive. 


tar -tvf /dev/rmt/4 


tac DLOCKsi ze = 20. 
drwxrwxrwx999/1 0 Sep 5 11 54 1990 : 
drwx------ O90 Se Ost A Oey ear / Mail 


“rwo-r--r--99971 17) Oot LO. 31430-1990 /meetingl 


e Extract the to.do file from a backup floppy disk. 
tar -xvf /dev/dsk/fd0 to.do 


° Copy all the files from the floppy disk onto the 
current directory of your hard disk. 


tar -xvf /dev/dsk/£d0 


¢ Make a backup copy of the current directory. 
tar -cvf /dev/rmt/4 


346 UNIX command reference 


Description Causes the results of a command (standard output) to 
be copied into a file at the same time it is being 
displayed on a screen. Usually, the tee command is 
part of a pipeline (see the examples below). 


Format tee file Copies standard output into a file. 


tee -a file Adds standard output to the end 
of the file instead of creating a 
new file. 


Examples e Display the man page for the ls command and add 
the text to the end of a file named mpages. 


man ls | tee -a mpages 


e Print the man page for the ls command and save it 
in the |s.file. 


man ls | tee ls.file | lp 
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telnet 








Description 


Formats 


telnet 
commands 


Example 


348 


Logs in to a remote system over a network even if it 
uses a different operating system or another version 
of UNIX. telnet communicates with a remote system 
using the TELNET protocol. Once connected, use the 
remote system as if you were directly logged in to it. 


telnet Enters command mode and 
displays a command prompt 
(telnet>). 


telnet remotesystem 


Connects directly to the remote 
system and displays a login 
prompt. 


Here’s a list of commands you can use while in telnet. 


Description 


close the current connection 


connect to another system 
exit telnet 
display help info 





¢ Access the remote system named crunch, then log 
in. 


telnet crunch 
Trying: 192.9° 180° 128 ee 
Connectéd toe crunch.  . 


UNIX(r) System V Release 4 0 (crunch) == 
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Description Displays the pathname of your current screen. 


Format tty Displays the pathname of your 
current screen. 


Example e Check the pathname of your active screen. 
tty 


/dev/term/con3 _ 
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type display the pathname of a command 


Description Displays the full pathname of a command; tells you 
where a command resides in the directory hierarchy, 
if that command is in your path. 


C shell note Use the which command rather than type in the C 
shell. 
Format type command Displays the pathname of the 


specified command. 


Examples ¢ Display the pathname of the more command. 
type more 


more is /usr/bin/more 


¢ Find out where your psf command comes from. 
type psf 


psf is an alias: for ps: =f 
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set or display system name 


Description Displays your system name and version; also can set 
your system name. 


Restrictions You must be root to change your system name. 


Formats uname Displays only the system name. 


uname -S system 


Sets the name of your Amiga to 
the specified system name. 


uname -a Displays the system name and the 
operating system release, name, 
and version. 


Examples ¢ Change your system name to utopia. 


uname -S utopia 


¢ Display the operating system version and release. 
uname -a 


UNIX System V utopia 4 0 Releasel 1 Amiga — | 
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displays active time — 





Description Displays the length of time the system has been 
active. 
Format uptime Displays the current time; the 


number of days, hours, and 
minutes the system has been 
active, and the number of users on 
the system. 


Example e Find out how many days the system has been active. 


uptime 
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visual editor 





Description Invokes the vi (visual) text editor. You can create and 
edit files in this editor. Here are some of the 
commands you use with vi. Refer to the Using the vi 
editor chapter for more information. 


iia 


move cursor up 

move cursor down 

move cursor left 

move cursor right 

start insert mode after cursor 
start insert mode before cursor 
start insert mode with a blank line 
quit insert mode 

save a file 

save and quit a file 

quit without saving 

delete a character 

delete a word 

delete a line 

delete to the end of a line 
undo the last command 
change a word 

erase a line and insert 
change to the end of a line 
cut (delete) a line 

cut (delete) n lines 

copy (yank) a line 

copy (yank) n lines 

paste below cursor 

paste above cursor 

search for term 

repeat last change 

repeat search (find next term) 


BC ua or a a 


TD 
© 
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write to all users 





Description Sends a message to all users who are logged in to your 
system. 
Restrictions To override the message state (mesg=n) on other 


users’ terminals, you must log in as root. 


Format wall Waits for you to type the message 
you want to send. When you 
finish typing the message, press 
CTRL-D; wall then sends your 
message. 


Example e Send a message to system users. 
wall 


The system will be down at lunch time. 


ClRbe) 


Broadcast message from root (console) on utopia Wed Oct 24 
Ui poe Seo ts eee 
The system will be down at lunch time 
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Formats 


Examples 


Description 


who 


who -uH 


who ami 


Lists users logged in to the system. 





Displays all active users on the 
system and indicates which 
virtual screens they are using and 
the date and time they logged in. 


Adds idle time, PID, and user 
comments to the who 
information. The H option adds 
headers. 


Displays your username, virtual 
screen (tty and console), and login 
date and time. 


¢ Make sure that a particular user is logged in to the 
system before talking to him. 


who 





¢ Find out how long Joe has been idle. 


who 


NAME LINE 


IDLE PID COMMENTS 


root console Oct 24 10 23 0 12 503. system console (Fl) 2 
joe term/cone Oct 19 02 05 |. i144 <2... 


¢ Find out which wsername you used to log in to the 


current screen. 
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Description 


Formats 


Example 


356 





whodo tT 





- who’s doing what 


Displays the process status for all users who are 
logged in to the system. The information displayed is 
similar to the information displayed by the ps 
command. 


whodo Displays the process status for 
each active user. 


whodo username 


Displays the process status for the 
specified user. 


whodo -l Lists whodo information in a 
single-line format. 


¢ Find out what processes Joe is running. 


whodo joe 


term/con2 joe Och 19.0905 : 
term/con7 144 0-00 ksh. 
term/con7 ~ 237. 0-00 csh 
_ term/cong = 68) = 0 00 whodo 
termm/coni joe = Och 12 09.05. 
- term/con? #144 # #8 00 ksh 
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Description 


Formats 


Examples 


Identifies systems that are allowed to connect with 
your X server, so you can run remote X applications 
from other systems. Also allows you to restrict the 
systems that can access your X server. Permanent 
access is stored in the /etc/X0.hosts file, so you don’t 
have to issue xhost commands each time you start X. 


xhost 


xhost + 


xhost + system 


xhost - 


xhost - system 


Lists the systems that are allowed 
to display to your X server. 


Allows all users to access your X 
server (by disabling xhost 
security). 


Adds a specific system to the list 
of systems allowed to access your 
X server. 


Limits access only to specific 
systems (by enabling xhost 
security). 


Removes a system from the list of 
systems that are allowed to access 
your X server. 


e Allow everyone on your network to connect X 
applications to your X server. 


xhost + 


¢ Remove the utopia system from the list of systems 
allowed to access your X server. 


xhost - utopia 
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Description 


Formats 


Examples 


358 


Sets X Window System user preferences such as the 
path to fonts, mouse speed, and the time before the 
screen saver appears. 


xset -q 


xset m acc dis 


xset r off or on 


xset s off or on 


xsetsnx 


Displays the current settings. 


Sets the acceleration rate and 
threshold distance for the mouse. 
acc multiplies the mouse speed if 
the mouse quickly travels dis 
pixels. 


Turns the keyboard autorepeat off 
or on. 


Starts or stops the screen saver if 
no activity occurs. 


Starts the screen saver after n 
seconds. If you include x in the 
command, xset changes the 
screen saver pattern every x 
seconds. 


e Start the screen saver if the server is inactive for 
more than 10 minutes (600 seconds). 


xset s 600 


¢ Set the mouse to move 4 times as fast as it normally 
would if it passes 6 pixels in a short period of time. 


xset m 4 6 
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xterm create an xterm window 


Description Creates an X Window System terminal window. You 
type UNIX commands into the xterm window just as 
you would type them into a virtual screen or another 
type of terminal. 


Formats xterm -sl lines Sets the number of lines scrolled 
off the window: 64 is the default; 
256 is the maximum. 


xterm -nname_ Changes the xterm window and 
icon titles. 


xterm -bg color Sets the xterm background color. 
xterm -fg color Sets the xterm foreground color. 


xterm -fn font Specifies the font you want to use. 
Check the directories under 
/usr/X/lib/fonts for available fonts; 
use the first part of the font name 
(the part before the period). 


Examples ¢ Start an xterm with the title "xterm number 1’. 
xterm —-n "xterm number 1" 


e Start an xterm using a large font and keeping the 
maximum number of scrollable lines. 


xterm -fn 8x13 -sl 256 
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You use special characters in commands to: 
e replace characters in names 


¢ move quickly between directories 


e perform special processes 


Use these characters to replace characters in names. 


Replacement 
characters 


asterisk; replaces any character(s) 
question mark; replaces a single 


character 

brackets with hyphen; matches a 
range of characters 

brackets with comma(s); matches a 
series of characters 





Use these characters to move quickly between 
directories. 


single period; current directory 
double periods; parent directory 
slash alone; root directory 
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special Use these characters to perform special operations. 
operation 


characters 


ampersand; background process 
greater than; redirect output to 
less than; redirect input from 

pipe; use the output of one process a 
the input for another process 
double exclamation points; execute 
the previous C shell command 
single quotes; treat the quoted 
sequence as one argument 
backslash; take the next characters 
literally 

separate commands on a command 
line 

parentheses; group multiple 
commands into one process 





Additional Additional special characters include: ", ‘, $, {, }, !, @, 
special and “. Read the shell man pages for more 
commands information about these special characters. 
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index 


Index 








Index 
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finding logs for 240 
acctcom 252 
active communications 156 
add text 106 
add users and machines to your system 181 
administering a system 195 
alias 253, 275 
aliases 21, 225 
Amiga enhancements 172, 174 
Amiga graphics 171, 174, 175, 176 
Amiga UNIX system files 181 
Amiga UNIX tape 226 
Amiga utilities 171, 173 
apropos 254 
apropos to search for man page topics 42 
arrow keys 105 
automate tasks 187 


B 


background process 362 
backing up files 232 
backup 
to a file on the hard disk 232 
to a floppy disk 232 
to floppy disk 232 
to tape drive 232 
baud rate 228 
be 255 
Berkeley commands 171, 173 
bg 221 
broadcasting a message 147, 152 


index 


buffer 109, 112 


C 


C 35 
C shell 220 
cal 256 
calculator 255 
calendar 256 
cancel 
print job 94 
print request 257 
cat 258 
categorizing the man pages 41 
catman command for man pages 44 
ed 51, 259 
change 
current directory to home directory 259 
current directory to parent directory 259 
current directory to root directory 259 
directories 49 
directory permissions 80 
file access permission 261 
file ownership 263 
file permissions 76 
file user group 260 
line 353 
mail folders 275 
password 199 
permissions 78 
screen colors 265 
system name 194 
terminal characteristics 338 
user information 201 
word 115 
change text 115 
character size 172, 174, 175, 176, 189 
chgerp 260 
chmod 78, 261 
chown 263 
clear screen 264 
columns 175 
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commands 


acctcom 252 
alias 253 
apropos 42, 254 
be 255 

bg 221 

cal 256 

cancel 257 

cat 64, 258 

cd 51, 259 
cherp 260 
chmod 78, 80, 261 
chown 263 
clear 264 

color 6, 265 

cp 69, 266 

cpio 233, 267 
crontab 269 
CTRL D 231 
date 270 

df 271 

disable 95 
display previous 220 
du 31, 272 

echo 218, 273 
elm 157, 274 
emacs 276 
enable 96 

env 218, 277 
execute previous 220 
exit 278, 325 
fdfmt 279, 345 
fo 221 

file 55, 280 

find 60, 61, 281 
Finger 283 
finger 24, 150, 282 
fsck 284 

ftp 286 

erep 288 

head 68, 289 
history 290 


init 176, 189, 191, 231, 291 


jobs 221, 292 

kill 29, 221, 293 

less 294 

In 295 

Ip 83, 90, 296 
lpadmin 85, 87, 89, 297 
Ipstat 33, 90, 93, 299 
Is 39, 57, 58 

mail 122, 156, 302 
man 39, 42, 303, 347 
mesg 304 

mkdir 53, 200, 305 
mkfs 213, 306 

more 27, 40, 65, 66, 308 
mount 3809 

mv 72, 73, 311, 331 
oladduser 312 

olinit 176, 313 
passwd 314 
passwdall 179, 315 
pg 316 

ping 317 

pipe 27 

pr 318 

ps 26, 151, 319 


pweonv 184, 199, 201, 320 


pwd 50, 321 

rcp 161, 322 

rdb 323 

rlogin 158, 325 

rm 74, 326 

rmdir 54, 327 

rn 328 

rwho 329 

sed 331 

set 218, 334 
setenv 218, 277 
shutdown 230, 337 
sioc 8, 175, 177, 178, 338 
sleep 340 
sort 341 


stty 342 
tail 67, 343 
talk 344 
tar 345 
tee 347 
telnet 348 
tty 349 
type 350 
uname 194, 351 
uptime 352 
vi 353 
vi colon commands 101 
wall 152, 354 
who 22, 149, 355 
whodo 356 
xhost 357 
xset 358 
xterm 360 
communicate with other users 155, 344, 348, 
354 
configuring 
serial port 191 
set up aliases 21, 225 
system environment 187 
virtual screens 21, 225 
console 191 
control the virtual screens 190 
conversions interface 83 
copy 
block of text 111 
directories 322 
files 69, 266, 322 
files and directories to/from device 267, 
345 
files to a new place 70 
files to/from other systems 147 
line 111 
mail messages 275 
screen display 347 
standard output 347 
text 112, 353 
countries 177,178 


index 


cp 266 
cpio 233, 267 
create 
directories 53 
create a crontab 236 
cron 269 
cron command 236 
crontab 269 
creating 236 
editing an existing entry 239 
sample entry 238 
crontab format 237 
csh 20, 223 
CTRL-C 155 
CTRL-D 152 
CTRL-Z 221 
cursor movement 104 
customize 
elm 275 
mail message signatures 136 
system environment 181, 187 
cut text 111, 112, 353 


D 


date and time 270 
default directories 52 
default font 8 
default keyboard 177 
default printer 86 
default screen settings 6 
default serial port 191 
delete 
block of text 108 
character 107, 353 
directories 327 
files 74 
files and directories 326 
line 108, 353 
mail 133 
mail messages 275 
printer 89 
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text 109 standard UNIX directories 53 


to end of file 108 tmp 53 
to end of line 353 usr 53 
word 107, 353 var 53 
destination file 70 disk 
destination path 70 allocation 271 
device name 205 change address 205 
df 271 check usage 31 
directories connect the SCSI cable 205 
elm 123 copy files and directories 345 


/mail 123 
/usr/amiga 171,174, 179 
Amiga UNIX 171, 179 


Amiga UNIX directory structure 48 


bin 37, 53 

change 49, 259 

change group 200 
change ownership 200 
change permissions 80 
check path to current 50 
copy to/from device 345 
copying with rep 322 
create 53, 200 

default 52 

dev 53 

display current 321 
elm folder 137 

etc 53 

home 50, 51, 53, 61, 145, 200 
li 800 

lost+found 53 

mnt 53 

mount 213 

move 311 

move among 361 

path 49, 200 

proc 53 

remove 54, 327 
rename 311 

retrieve 345 

root 48 

sbin 53 


create a filesystem 213 
create a mount directory 213 
device name of 205 
format 180, 279 
mount 215 
partitioning 323 
usage 272 

display 
command pathname 350 
current directory pathname 321 
file contents 63, 67, 68, 258, 289, 294, 

308, 316, 343 

process status 356 
shell and environment variables 218 
system information 351 
terminal characteristics 342 
terminal pathname 349 
time system is active 352 
user status 355 

double clicking 15 

du 272 


E 


echo 218, 273 
edit text 115 
editor 276 
elm 137 
stream editor 331 
v1 353 
electronic mail 121-142, 157, 274, 302 
elm 121-142, 157, 274 


index 


.elm directory 123 

calendar 137 

change mail folders 275 
change selection indicator 137 
change text editor 137 
command formats 124 

copy mail messages 275 
customize 275 

customize signatures 136 
delete mail messages 133, 275 
folder directory 137 

forward a mail message 275 
group reply 275 

help 275 

local signature 136 


env 218, 277 
environment variables 216, 277, 336 


define home directory (HOME) 217 

define search path for commands (PATH) 
217 

define shell prompt (PS1, PS2) 217 

define the log in shell (SHELL) 217 

define type of terminal (TERM) 217 

define username (LOGNAME) 217 

display 218 

file containing set-up and alias 
commands (ENV) 217 

number of commands kept in history file 
(HISTSIZE) 217 

set 218 


mail a file 124 

mail messages 275 
mailbox screen 123, 128 
menu 137 

message line, description 130 
name display option 137 
options 275 

outbound file 137 

print a mail message 275 
print option 137 

quick quit 275 

quit 132, 275 

read mail 275 

redraw screen 275 
remote signature 136 
reply 275 

save mail messages 275 
search 275 

set up 123 

shortcut 124 

skip mailbox screen 124 
sort order 137 

undelete 275 

user level 137 


ESC, with vi 100 
executing files 76 
exit 278, 325 


F 


fdfmt 180, 279, 345 
fg 221 
file systems 192 
create 213, 306 
define 214 
mount 309 
user directory 53 
File Transfer Protocol (ftp) 286 
file types 55, 280 
check a file’s type 55 
devices 55 
directories 55 
executables 55 
special 55 
text or data 55 
files 267 
profile 37, 216 
rhosts 159, 170 


emacs 276 
encrypted passwords 198 
ENV 217 


Index 


/etc/hosts 165 
/etc/inittab 176, 189 
/etc/nodename 194 
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/etc/passwd 199, 200, 201, 320, 325 

/etc/profile 187 

/etc/shadow 199 

/etc/vfstab 213 

attributes 75 

change permissions 76, 78 

copy 69, 266 

copy to/from device 345 

define file containing set-up and alias 

commands 217 

delete 74 

destination 70 

display contents of 63, 64, 294, 308 

display file type 280 

display 
one page at a time 316 
first screen of 68, 289 
last screen of 67, 343 
one page at a time 65 

elm calendar 137 

elm local signature 136 

elm options (.elmrc) 138 

elm remote signature 136 

execute 76 

find 60, 61, 281 

format 318 

eroup 7/6 

history file 217, 220 

hosts 194 

install optional 226 

link 295 

list 57, 58, 300 

list in long format 75 

move 72, 73 

outbound mail 137 

owner 76 

path to 64 

permissions 75 

print 296 

read 76 

remote copy 322 

remove 326 


rename 72 
retrieve 345 
save 353 
search 288 
sort 341 
source 70 


using wildcard substitutions in names 60 


vistab 192 
find 
files 60, 61, 281 
next 117, 353 
phrase 288 
Finger 283 
finger 282 
floppy disk 180 
fonts 8, 172, 174, 175, 189, 338 
format 
disk 180, 279 
files 318 
forward a mail message 275 
fsck 284 
ftp 286 


G 


getscr 179 

global tasks 147 

global world 144, 146 

graphical user interface 9, 10 
workspace 11 

graphics 171, 174, 175, 176 

erep 288 

group reply to mail message 275 

eroups 185 


H 


hard disk 192, 208 
create directory 305 
examine using fsck 284 
hard link 295 
head 68, 289 


Index 


help 303 
elm 275 


high resolution graphics 171, 174, 175, 176 


history 290 

HISTSIZE 217, 220 

HOME 217 

home directory 50 
returning to 51 


I 


init 291 

init levels 188, 291 

init state 337 

insert mode 353 

install optional files 226 


J 


job 35 
jobs 221, 292 
join lines 110, 111 


K 


keyboard 358 

keymaps 6, 173, 174, 177, 178 
kill 29, 221, 293 

Korn shell 35, 220 

ksh 20, 223 


L 


less 294 

list 
active processes 221, 319 
current users 147 
files 57, 58, 75 
files and directories 300 
processes 147 
running processes 22 
system users 149 


Index 


users on network 329 
In 295 
local tasks 147 
local world 144, 146 
log in 325 
log in to another system 145 
login name 150, 155, 200 
login shell 200 
LOGNAME 217 
loop program 340 
Ip 90, 296 
lp print service 83 
lpadmin 89, 297 
Ipstat 33, 938, 299 
Is 39, 57 


M 


mail 122, 156, 302 
a file 124 
customize signatures 136 
delete 133 
message selection indicator 137 
messages 275 
name display option 137 
read 275 
reply 275 
save 275 
send 147 
sort order 137 
mailbox 156 
man 308, 347 
man page 
basic format 41 
categorizing types 41 
description of 39 
directories where pages are stored 42 
list topics 42 
move around in 40 
request 39 
to preformat man pages 44 
using apropos to search for topics 42 


using whatis to get command description 
44 
matching file patterns 60 
menus, OPEN LOOK 12 
mesg 304 
mkdir 538, 305 
mkfs 306 
more 65, 66, 308 
mount 309 
mount directory 213 
mount disks and filesystems 192 
mount point 53 
mouse 
doubling clicking options 15 
speed 358 
move 
files 72, 73 
text 112 
multi-tasking 22 
multi-user 22 
multi-user mode 188, 231 
mv 72, 311, 331 


N 


name a machine 181 
name a system 194 
network 
add system names 193 
administer a system 195 
administration tasks 167, 195 
broadcast a message 152 
change system name 194 
check disk usage 31 
check on remote systems 157 
check running processes 150 
check system name 194 
check user status 150 
communicate with other users (talk) 154 
copy files to/from other systems 161 
display users 329 
list system users 149 


370 


local vs global worlds 144 
log into a remote system 158 
multi-user mode 188 
multi-user multi-tasking 22 
name a system 194 
send mail messages 156 
set up 164 
using ps to check on processes 151 
news system 328 
nodename 194 
nroff 111 


O 


oladduser 9, 10, 312 
olinit 5, 7, 9, 20, 176, 223, 313 
on-line reference 303 
OPEN LOOK 5, 7, 9,10, 11, 20, 176, 223, 312, 
313 
cut and paste commands between 
windows 16 
making a window active 15 
menus 
using mouse with 12 
scrolling back through old xterm 
commands 19 
start a terminal window 17 
starting 10 
terminal windows 16 
three types of menu options 13 
windows and common features 15 
workspace menu 
window menu 14 
overscan 176 


P 


partitions 179, 208 
passwd 314 

passwd file 183, 197 
passwdall 179, 315 
passwords 314, 315 


index 


paste text 353 

PATH 217 

path destination 70 
path to a file 64 
pathname 217, 321, 349, 350 
permissions 75, 78 

pg 316 

ping 317 

pipe 362 

postcript printer 86 
postscript interface 91 
power off 231 

pr 318 

prepare disk 180, 208 
print scheduler 84 


print working directory (pwd) 50 


printing 
add a printer 85 
cancel a job 94 
change printers 88 
check print jobs 33, 93 


check status of print jobs 299 


conversion interface 83 
default printer 86 
define a printer 85, 297 


delete a printer from lpadmin 89 


disable a printer 95 
elm customization 137 
enable a printer 96 
files 90, 296 


identify the device name 83 


mail message 275 

set up a printer 83 
starting lpsched 96 

to a different printer 90 


with a postscript interface 91 


process ID (PID) 29, 319 
processes 293 
background process 221 


check running processes 151 


list 26, 147 


put job in background 221 


Index 


put job in foreground 221 


running on your local machine 151 


terminate using CTRL-Z 221 
terminate using kill 29, 221 
prompt 216 
protect files from other users 75 
ps 319 
PS1 217 
PS2 217 
public domain programs 172 
public domain source code 226 
punctuation mark 115 
pwceonv 320 
pwd 321 


Q 


quit 
elm 132, 275 


R 


rcp 322 
rdb 179, 208, 323 
read mail 274 
reading a man page 41 
redirection 331, 362 
redraw screen 101, 275 
release 4.0 enhancements 172, 173 
remote log in 325 
remote system 157 
remote system, access 348 
remove directories 54 
remove files and directories 326 
rename files 72 
repeat command 353 
replace 

line 115 

word 114,115 
replacement characters 361 
resolution 175, 176, 191, 338 
respawn 228 


371 


restart a system 231 
restricted 35 

restricted environment 200 
restricted shell 37 
RETURN, with vi 100 
rlogin 158, 325 

rm 74, 326 

rmdir 54, 327 

rn 328 

root 56 

rows 175 

running processes on your local machine 151 
rwho 329 

rwhod 329 


S 


save a file 353 
save and quit a file 353 
SCHEDLOCK 96 
scheduling processes 269 
screen colors 6, 172, 174, 179, 189, 265 
screen management 172 
screen name 191 
screen saver 358 
scrolling through a window 15 
scrolling through windows 19 
search 

elm 275 

for files 60 

v1 353 
security 179 
sed 331 
send mail 147 
send a message to users 153, 354 
send mail 156 
serial devices 188, 191 
serial network 165 
serial printers 87 
set 218, 334 
set displaytype 175 
set font 8 


372 


set keyboard 177, 178 
setenv 218, 277 
setting up a printer 83 
shadow file 184, 198 
share files 185 
SHELL 217 
shell variables 216, 333 
shells 216—221 

Bourne 35 

prompt 216 

scripts 216 

variables 218, 219 
show color 6 
shutdown 337 
single user mode 188 
sioc 338 
sleep 340 
sort 341 

mail messages 137 
source file 70 
special characters 361, 362 
special operation characters 362 
spreadsheet program 330 
standard directories 53 
standard login session 187 
stream editor 331 
stty 342 


substituting filename characters 60 


suspend a command 340 

symbolic link 295 

system 
check status 22, 317 
configuration files 53 
list users 149 
maintenance 147 
name 351 
usage 252 

system administrator 195 


T 


tail 67, 343 


Index 


talk 101, 153, 154, 155, 344 
tar 345 

tee 347 

telnet 348 

temporary buffer 109, 112 
TERM 217 

terminal 149 

terminal characteristics 342 
terminate process 29, 293 
troff 91 

tty 349 

type 350 


U 


uname 194, 351 

undelete mail message 275 
undo 353 

UNIX accounting files 240 
update the shadow file 199 
uptime 352 

user status 


Finger 283 
finger 282 


users 


V 


add new 184 

add new groups 185 
change information for 201 
changing into su 56 
display process status 356 
display status 355 

home directory 53 

list 147 

list network users 329 

list system users 22 
logged into your machine 152 
root 56, 152 


variables 


environment 216, 277, 336 


Index 


shell 216, 333 


vistab 192 
vi 353 


add text 106 
append text 106 
arrow keys 105 
change 

line 353 

to end of line 353 

text 115 

word 115, 353 
change commands, chart 114 
colon commands 101 
command mode 100 
copy line 111 
copy block of text 111 
copy text 112, 353 


cursor movement commands, chart 104 


cut text 111, 112, 353 
delete 109 
block of text 108 
character 107, 353 
line 108, 353 
to end of file 108 
to end of line 353 
word 107, 353 
delete commands, chart 107 
find next occurrence 353 
find next 117 
insert blank line 106 
insert mode 100 
insert text 353 
join lines 110, 111 
move and copy commands, chart 110 
move text 112 
paste text 353 
quit without saving 102 
repeat command 353 
replace line 115 
replace word 114, 115 
save a file 353 
search 353 


373 


search commands, chart 117 
set wrapmargin 101 
switch between modes 100 
temporary buffer 109, 112 
undo 353 
undo commands, chart 118 
yank text 111,112 
virtual screens 5, 23, 172, 174, 176, 188, 189, 
190, 226 


W 


wall 354 
whatis command 44 
who 355 
whodo 356 
wildcard characters 60, 74 
window size 338 
windows 11 
OPEN LOOK 15 
xterm 16 
wrapmargin 101 


X 


X server 357 

X Window System 5, 174, 176, 312, 358, 359, 
360 

X Window System development tools 226 

Xamix 176 

Xenix commands 171, 173 

xhost 357 

xset 358 

xterm 360 


Y 


yank text 111,112 
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